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 authentication

Format: 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"
  }'