Auth Setup
Create an API key, find your inbound webhook URL and register an outbound webhook with its signing secret.
Showing instructions for Xebit VoiceCloud.Showing instructions for Xebit VoiceKit, on your own infrastructure. Switch with the selector at the top. Updated 22 October 2026.
Three credentials cover every way of talking to Xebit: an API key for the REST API, a secret inbound webhook URL for tools that can only send a POST, and a signing secret for the outbound webhooks Xebit sends to you. All three are managed on the Integrations page of the Xebit VoiceCloud dashboardthe Xebit VoiceKit admin console.
API key
An API key gives a program access to the Xebit API.
- Open the Xebit VoiceCloud dashboard → Integrations → API Keysthe Xebit VoiceKit admin console → Integrations → API Keys.
- Choose Generate New Key and pick the scopes the integration needs.
- Copy the key straight away. It is shown once and cannot be retrieved later.
Send the key in the x-api-key header on every request:
x-api-key: YOUR_API_KEYInbound webhook URL
An inbound webhook URL lets an outside tool create, cancel or delete calls without handling an API key. The secret token inside the URL is the credential.
- Open the Xebit VoiceCloud dashboard → Integrations → Inbound Webhooksthe Xebit VoiceKit admin console → Integrations → Inbound Webhooks.
- Copy your unique inbound URL.
- Use it as the destination for
POSTrequests from your tool.
Example: https://api.voice.xebit.ai/v1/hooks/{YOUR_SECRET_TOKEN}
Example: https://<your-xebit-voicekit-host>/v1/hooks/{YOUR_SECRET_TOKEN}
Outbound webhook events
Outbound webhooks are how Xebit tells your server what happened on a call, as it happens.
- Open the Xebit VoiceCloud dashboard → Integrations → Webhook (Outbound)the Xebit VoiceKit admin console → Integrations → Webhook (Outbound).
- Enter your HTTPS endpoint URL.
- Select the events you want, for example
call.completed. - Copy the webhook secret. You need it to verify signatures.
Signature verification
Each delivery carries an X-Webhook-Id header holding the event's event_id, plus two signing headers:
| Header | Description |
|---|---|
X-Webhook-Timestamp | Unix time in seconds at which the payload was signed. It is part of the signed string. |
X-Webhook-Signature | The signature, formatted as v1=<base64-encoded HMAC-SHA256>. |
The signature is HMAC-SHA256(secret, "{timestamp}.{rawBody}"), Base64 encoded (not hex) and prefixed with v1=. X-Webhook-Id is not signed; only the timestamp and the raw body are.
Use the secret exactly as displayed, whsec_ prefix included. The prefix is part of the HMAC key. Do not remove it and do not Base64 decode the secret. The full rules and common mistakes are on Outbound Webhooks.
# Send a signed test delivery to your own endpoint
SECRET="YOUR_WEBHOOK_SECRET"
TIMESTAMP=$(date +%s)
PAYLOAD='{"event_id":"evt_123","event_type":"call.completed"}'
SIG="v1=$(printf '%s.%s' "$TIMESTAMP" "$PAYLOAD" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64)"
curl -X POST https://your-server.example.com/webhook \
-H "Content-Type: application/json" \
-H "X-Webhook-Timestamp: $TIMESTAMP" \
-H "X-Webhook-Signature: $SIG" \
-d "$PAYLOAD"import base64
import hashlib
import hmac
def verify_signature(secret: str, timestamp: str, raw_body: bytes, signature: str) -> bool:
message = f"{timestamp}.".encode() + raw_body
expected = base64.b64encode(
hmac.new(secret.encode(), message, hashlib.sha256).digest()
).decode()
return hmac.compare_digest(f"v1={expected}", signature)const crypto = require("crypto");
function verifySignature(secret, timestamp, rawBody, signature) {
const expected = "v1=" + crypto
.createHmac("sha256", secret)
.update(`${timestamp}.${rawBody}`)
.digest("base64");
const a = Buffer.from(expected);
const b = Buffer.from(signature || "");
return a.length === b.length && crypto.timingSafeEqual(a, b);
}Configuration summary
| Integration point | Authentication | Best for |
|---|---|---|
| Call API | x-api-key header | Backend logic and scheduling |
| Inbound webhooks | Unique secret token in the URL | No-code tools and simple CRM triggers |
| Outbound webhooks | X-Webhook-Signature (HMAC-SHA256) | Real-time status sync and outcome logging |
Keep API keys and webhook secrets out of public repositories and client-side code. Load them from environment variables on your server.