WiseParts
API

Authentication

How to get a token and send it with every request.

Every request carries the token of the integration it belongs to. The token identifies both the account and which integration the call is for, so there is no separate account identifier.

Navigate to Integrations, open the integration you are connecting, and copy the token from its configuration. Each integration has its own token.

Send it as a bearer token:

curl https://app.wiseparts.ai/api/v1/voice/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "id": "abc-123", "from": "+351210000000", "direction": "inbound", "status": "ringing" }'

An api_token query parameter is also accepted, for phone systems that cannot set headers:

POST /api/v1/voice/call?api_token=YOUR_TOKEN
Keep the token secret. Anyone holding it can write call and message records into your account. If it leaks, use the refresh button next to the token to generate a new one — the old token stops working as soon as you save.