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 contact id for outbound and appointment campaign tests: the GoHighLevel contact id, or the nct_ id on a sub-account with no CRM. 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 contact from these details when contactId is omitted. The contact is made wherever the sub-account keeps its contacts. 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
