Use an organization API key to authenticate Blooio v4 API requests. Treat the key like a password and never expose it in browser code or public repositories.

#Create and configure the key

1. Open API Keys from the left sidebar in your Blooio dashboard.
2. Select Create Key, give the key a recognizable name, and optionally choose an expiration date.
3. Copy the key when it is shown and store it in your secret manager. You will not be able to view the complete key again.
4. Open Channels and assign the active sender channels this key may use. Their order controls the sending priority when a request does not specify a sender.

#Authenticate a v4 request

Send the key in the Authorization header as a Bearer token. The current API base URL is https://api.blooio.com/v4.

curl 'https://api.blooio.com/v4/me' \
  --header 'Authorization: Bearer YOUR_API_KEY'

#Validate message routing

Use POST /v4/messages with typed content. The dry_run option validates the request and selects a sender without sending a message.

curl --request POST 'https://api.blooio.com/v4/messages' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: help-center-test-001' \
  --data '{"to":"+15551234567","content":{"type":"text","text":"Hello from Blooio v4"},"dry_run":true}'