Create Webhook action

POST

/smartflows/{smartflowId}/actions/webhook

The Webhook action sends contact data to an external URL whenever a contact reaches this point in the workflow. It's essential for integrating with third-party systems like CRMs, ERPs, or custom applications

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/smartflows//actions/webhook' \
--header 'Authorization: Bearer JWT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Custom activity name",
    "ancestorId": "4a06896c-81b3-44f4-b493-2057bef951a2",
    "url": "https://facebook.com/webhooks/sfasf351",
    "method": "get",
    "headers": [
        {
            "key": "authorization",
            "value": "s;fljeklsff456s"
        }
    ],
    "body": "{\"data\":{\"firstname\":\"John\",\"lastname\":\"Doe\",\"email\":\"john.doe@gmail.com\"}}",
    "onError": "dontCare",
    "saveResponse": [
        {
            "jsonPath": "data.contact_id",
            "contactField": "facebook_id"
        }
    ]
}'

Response Example

200 - Success

{
    "activityId": "4a06896c-81b3-44f4-b493-2057bef951a2",
    "name": "Custom activity name",
    "campaignUuid": "4a06896c-81b3-44f4-b493-2057bef951a2",
    "nextActivityType": "triggers"
}

Modified at 2026-06-11 02:37:32

Delete Webhook action

Get Meta audience action