Beehive AI supports secure, scalable webhook ingestion for Medallia survey data and event payloads from enterprise customers. This integration allows external systems to push real-time data to Beehive’s platform over HTTPS using OAuth 2.0 (Client Credentials Grant).
The system is designed with multi-tenant security in mind, ensuring each client has isolated credentials.
Getting Started
To start sending Medallia events to Beehive AI’s webhook API, you’ll need a unique set of credentials and access configuration. Please follow the steps below to get onboarded:
Contact Beehive AI Support
Reach out to your Beehive AI point of contact to begin the onboarding process. We will provision a dedicated Client for your organization.
Receive Your Credentials
Once configured, we will securely share your Client ID and Client Secret. These credentials are used to authenticate with our system using OAuth 2.0 (Client Credentials Grant).
Audience & Permissions
Your credentials will be configured to use the audience https://beehive.ai/medallia, which grants access to the Medallia Webhook API.
Use Our Example Tools
We’ll provide you with sample curl commands and API payload formats to help you test and integrate quickly.
Confirm Integration
Once you begin sending data, we’ll help you validate delivery and debug as needed using request logs and trace IDs to ensure everything is working as expected.
Authentication & Authorization Setup
Step 1: Get an OAuth 2.0 Token
To post data into Beehive’s Medallia Webhook API, the client must first obtain a bearer token from Auth0.
Token Request Endpoint: https://<your-auth-domain>/oauth/token
Payload Format:
curl --request POST \
--url https://<your-auth-domain>/oauth/token \
--header 'content-type: application/json' \
--data '{
"client_id":"YOUR_CLIENT_ID",
"client_secret":"YOUR_CLIENT_SECRET",
"audience":"https://beehive.ai/medallia",
"grant_type":"client_credentials"
}'
Notes:
Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with credentials provisioned for your company.
The audience must match the Beehive API identifier: https://beehive.ai/medallia.
Step 2: Call the Medallia Webhook API
Use the token received from the Auth0 exchange to post your data.
API Endpoint: https://<your-webhook-domain>/medallia
HTTP Method: POST
Headers:
Authorization: Bearer <access_token>
Content-Type: application/json
Sample Request:
curl -X POST https://<your-webhook-domain>/medallia \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
"event": "survey_completed",
"data": {...}
}'
Security Considerations
Each customer has a dedicated client with unique credentials.
Tokens expire periodically, ensuring short-lived access.
Rate limiting and IP whitelisting are available per customer upon request.
Webhook traffic is enforced over HTTPS with TLS 1.3+.