Create a call action

POST

https://api.smallest.ai/atoms/v1/call-actions

POST

/atoms/v1/call-actions

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/call-actions"
4 
5 payload = {
6     "agentId": "64b8f9a2e4b0c123456789ab",
7     "category": "trigger",
8     "provider": "hubspot"
9 }
10 headers = {
11     "Authorization": "Bearer <token>",
12     "Content-Type": "application/json"
13 }
14 
15 response = requests.post(url, json=payload, headers=headers)
16 
17 print(response.json())

1 {
2   "success": true,
3   "data": {
4     "_id": "64b8fa12e4b0c123456789ac",
5     "organization": "64b8f8f1e4b0c123456789aa",
6     "agentId": "64b8f9a2e4b0c123456789ab",
7     "category": "trigger",
8     "provider": "hubspot",
9     "action_type": "create",
10     "object": "contact",
11     "config": {
12       "phoneNumberFieldName": "phone",
13       "conditions": [
14         {
15           "field": "lifecycle_stage",
16           "operator": "eq",
17           "value": "lead"
18         }
19       ],
20       "body": "{\"properties\":{\"firstname\":\"{{firstName}}\",\"lastname\":\"{{lastName}}\"}}"
21     },
22     "createdAt": "2024-01-15T09:30:00Z",
23     "updatedAt": "2024-01-15T09:30:00Z"
24   }
25 }

Creates a new call action for an agent. Call actions define automated behaviors that fire at specific points in a call lifecycle.

trigger actions fire to initiate an outbound call and require config.phoneNumberFieldName.
post-call actions fire after a call ends (e.g. to update a CRM record).

Creates a new call action for an agent. Call actions define automated behaviors that fire at specific points in a call lifecycle. - **`trigger`** actions fire to initiate an outbound call and require `config.phoneNumberFieldName`. - **`post-call`** actions fire after a call ends (e.g. to update a CRM record).

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Request

This endpoint expects an object.

agentIdstringRequired

Agent this action belongs to (ObjectId)

categoryenumRequired

When the action fires

Allowed values:

providerstringRequired

Integration provider (e.g. hubspot, salesforce)

configobjectRequired

action_typeenumOptional

The operation to perform on the provider object

Allowed values:

objectstringOptional

Provider object type to act on (e.g. contact, deal)

Response

Call action created

successboolean

dataobject

A call action that fires automatically at a specific point in the call lifecycle

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error