Skip to content

Get an action

Retrieves a single action by ID. Only custom actions and PAYMENT actions can be retrieved through this endpoint — other types return 400.

For broader timeline queries (calls, messages, system events), use search actions.

Request

FieldValue
MethodGET
URLhttps://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/lead/{leadId}/action/{actionId}
AuthBearer token (Sync-typed). See Authentication.

Path parameters

NameTypeRequiredDescription
enterpriseIdstringyesThe enterprise (workspace) ID.
leadIdstringyesThe lead's ID.
actionIdstringyesThe action's ID.

Example request

bash
curl "https://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/lead/603d2b2f9b1e8a001c8e4f5c/action/603d2b2f9b1e8a001c8e4f5d" \
  -H "Authorization: Bearer YOUR_SYNC_TOKEN"

Responses

200 OK

Returns either a custom action or a payment action depending on its type.

Custom action:

json
{
  "type": "1001",
  "fields": {
    "note": "Site visit completed"
  }
}

Payment action:

json
{
  "type": "PAYMENT",
  "status": "COMPLETED",
  "currency": "INR",
  "amount": "5000"
}

400 Bad Request

The action exists but its type is not retrievable through the public API.

json
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Only custom actions and payment actions can be retrieved"
  }
}

401 Unauthorized

See the universal 401 in the overview.

404 Not Found

json
{
  "error": {
    "code": "ACTION_NOT_FOUND",
    "message": "Action with ID 62ab16e was not found."
  }
}