Make your first request

Confirm your key works with a read-only request before sending. List reply destinations for your workspace:

curl https://app.beepmessaging.com/api/v1/reply-destinations \
  -H "Authorization: Bearer beep_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Workspace-Id: 22222222-2222-2222-2222-222222222222"

A 200 with a data array confirms your key and workspace scoping are correct. A 401 (authentication_required) means the key is wrong; a 403 means the key can't act on that workspace; a 404 (workspace_not_found) means an organization-scoped key is missing the X-Workspace-Id header.

Every workspace ships with a default beep_inbox reply destination, so this list is never empty.

Next steps

• Send your first message (Quickstart)