POST
/
api
/
v2
/
integration-schema
/
:slug
/
actions
/
:action_id
/
execute
curl -X POST "https://api.gocobalt.io/api/v2/integration-schema/hubspot/actions/create_contact/execute" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "example@google.com",
    "lastname": "Smith",
    "firstname": "John",
    "company": "Google Inc.",
    "jobtitle": "Software Engineer"
  }'
{
    "data": {
        "id": "118448752960",
        "properties": {
            "createdate": "2025-05-01T09:27:51.177Z",
            "email": "dhananjay+2@gocobalt.io",
            "firstname": "Dhananjay",
            "lastname": "Senday",
            "hs_all_contact_vids": "118448752960",
            "hs_email_domain": "gocobalt.io",
            "hs_full_name_or_email": "Dhananjay Senday",
            "hs_is_contact": "true",
            "hs_object_id": "118448752960",
            "hs_object_source": "INTEGRATION",
            "hs_object_source_id": "3630854",
            "hs_object_source_label": "INTEGRATION",
            "hs_pipeline": "contacts-lifecycle-pipeline",
            "lastmodifieddate": "2025-05-01T09:27:51.177Z",
            "lifecyclestage": "lead",
            "num_notes": "0"
        },
        "createdAt": "2025-05-01T09:27:51.177Z",
        "updatedAt": "2025-05-01T09:27:51.177Z",
        "archived": false
    },
    "node_status": "Success",
    "http_status": 200
}
This API executes a specific action within an integration application. The request body should contain the parameters required for the action as defined by the action’s parameter schema.

Request description

This API supports two authentication methods. You can use either Session Token authentication OR the combination of API key and linked account ID.

Authentication Option 1: Session Token

Authorization
string
required
Bearer token using your session token for authenticationFormat: Bearer YOUR_SESSION_TOKEN

Authentication Option 2: API Key + Linked Account

x-api-key
string
required
Your Cobalt API key
linked_account_id
string
required
The unique identifier for the linked account

Path Parameters

slug
string
required
The unique identifier for the integration application (e.g., “hubspot”, “salesforce”)
action_id
string
required
The unique identifier for the specific action to execute (e.g., “create_contact”, “create_deal”)

Body Parameters

*
object
required
Dynamic parameters based on the action’s schema. Use the “Get Action Parameters” endpoint to retrieve the required and optional parameters for the specific action.
The body structure varies depending on the action being executed. Each action has its own set of required and optional parameters.

Response description

data
object
The response data from the integration application
node_status
string
Execution status of the action (Success, Failed, etc.)
http_status
integer
HTTP status code from the integration application
{
    "data": {
        "id": "118448752960",
        "properties": {
            "createdate": "2025-05-01T09:27:51.177Z",
            "email": "dhananjay+2@gocobalt.io",
            "firstname": "Dhananjay",
            "lastname": "Senday",
            "hs_all_contact_vids": "118448752960",
            "hs_email_domain": "gocobalt.io",
            "hs_full_name_or_email": "Dhananjay Senday",
            "hs_is_contact": "true",
            "hs_object_id": "118448752960",
            "hs_object_source": "INTEGRATION",
            "hs_object_source_id": "3630854",
            "hs_object_source_label": "INTEGRATION",
            "hs_pipeline": "contacts-lifecycle-pipeline",
            "lastmodifieddate": "2025-05-01T09:27:51.177Z",
            "lifecyclestage": "lead",
            "num_notes": "0"
        },
        "createdAt": "2025-05-01T09:27:51.177Z",
        "updatedAt": "2025-05-01T09:27:51.177Z",
        "archived": false
    },
    "node_status": "Success",
    "http_status": 200
}
curl -X POST "https://api.gocobalt.io/api/v2/integration-schema/hubspot/actions/create_contact/execute" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "example@google.com",
    "lastname": "Smith",
    "firstname": "John",
    "company": "Google Inc.",
    "jobtitle": "Software Engineer"
  }'