Skip to main content
POST
Dispatch a CRM agent tool action

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
provider
enum<string>
required

CRM provider the action belongs to.

Available options:
hubspot,
salesforce,
zendesk,
calendly,
intercom
action
string
required

Registered CRM tool action to run for the provider (e.g. hubspot_create_contact).

args
object

Action arguments the model produced. Defaults to an empty object.

agent_id
string

Optional agent identifier, recorded for audit logging.

agent_run_id
string

Optional agent-run identifier, recorded for audit logging.

conversation_id
string | null

Optional conversation the tool call belongs to.

Response

200 - application/json

Structured dispatch result. ok is true when the action succeeded and response carries the provider's output; on failure ok is false with a machine-readable error code and a safe message.

data
object
Example:
meta
object