Retrieve a campaign agent

Fetch a single Campaign Manager agent by ID, including its answer and hangup webhook configuration and static SIP headers.

GET /api/v1/account/{account_id}/campaign/agents/{agent_id}

Retrieve a campaign agent

cURL

curl --request GET \
  --url https://api.vobiz.ai/api/v1/account/{account_id}/campaign/agents/{agent_id} \
  --header 'X-Auth-ID: <x-auth-id>' \
  --header 'X-Auth-Token: <api-key>'

GET https://api.vobiz.ai/api/v1/account/{account_id}/campaign/agents/{agent_id}

Returns the full configuration of one agent.

Authentication required

• X-Auth-ID — your Vobiz account ID
• X-Auth-Token — your Vobiz auth token

account_id · string · required

Your Vobiz account ID. Use the same value in X-Auth-ID.

X-Auth-ID · string · required

Your Vobiz account ID, for example MA_XXXXXXXX.

agent_id · string · required

ID of the agent, returned by Create an agent.

Example

cURL

curl "https://api.vobiz.ai/api/v1/account/{account_id}/campaign/agents/{agent_id}" \
  -H "X-Auth-ID: {account_id}" \
  -H "X-Auth-Token: {auth_token}"

Response

200 OK

{
  "id": "9f1c4b6a-2f0e-4a3d-8b21-6c5f0d9a7e42",
  "name": "Appointment Reminder Agent",
  "answer_url": "https://example.com/answer",
  "answer_method": "POST",
  "hangup_url": "https://example.com/hangup",
  "hangup_method": "POST",
  "static_headers": [
    { "key": "X-Campaign-Type", "value": "reminder" }
  ],
  "created_at": "2026-08-28T09:14:22Z",
  "updated_at": "2026-08-28T09:14:22Z"
}

An agent that does not exist for the authenticated account returns 404.