Create campaign test run
Start a test run for this agent’s campaign.
Required API key scope: calls:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Path Parameters
Agent id.
1Query Parameters
Pair with campaignId; omit both for primary campaign.
1Pair with locationId; omit both for primary campaign.
1Body
Existing GHL contact id for outbound/appointment campaign tests. The dashboard resolves this client-side. Use null for inbound dial-in tests.
"contact_123"
API-convenience alternative to contactId: create — or reuse, deduped by phone — a GHL contact from these details when contactId is omitted. No marker tag is applied. contactId wins when both are sent.
Tester phone number for inbound dial-in tests.
"+14155559876"
When true, run an agent-only inbound test without campaign side effects.
false
