POST
/
webhook-messages
curl --request POST \
  --url https://api.us.vartiq.com/webhook-messages \
  --header 'Content-Type: application/json' \
  --header 'companyid: <companyid>' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "appId": "<string>",
  "payload": {}
}'
{
  "success": true,
  "message": "<string>",
  "data": {
    "webhookMessage": {
      "id": "<string>",
      "isDelivered": true,
      "payload": "<string>",
      "signature": "<string>",
      "headers": [
        {}
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>"
    },
    "webhookMessageAttempt": {
      "id": "<string>",
      "isProcessed": true,
      "isResend": true,
      "statusCode": 123,
      "response": "<string>",
      "headers": [
        {}
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  }
}

Headers

companyid
string
required

The unique identifier of your company

Body Parameters

appId
string
required

The unique identifier of the app to send the webhook message to

payload
object
required

The payload to be sent in the webhook message

Response

success
boolean

Indicates if the request was successful

message
string

A message describing the result of the operation

data
object

The created webhook message details

Response Example

{
    "data": {
        "webhookMessage": {
            "headers": [
                {
                    "key": "x-app",
                    "value": "x-value",
                    "_id": "6812160256d753f3b41e1c66"
                },
                {
                    "key": "Content-Type",
                    "value": "application/json",
                    "_id": "6812160256d753f3b41e1c67"
                }
            ],
            "id": "wm_01JT3AC28MCG19W3DP8XG99832",
            "isDelivered": false,
            "payload": "{\"hello\":\"one\"}",
            "signature": "ba245c491633352932de63696a47de3d3da5d75e61b09ecc7614a5979b0db762",
            "webhook": "6812160256d753f3b41e1c65",
            "_id": "6812160656d753f3b41e1c6a",
            "createdAt": "2025-04-30T12:22:30.426Z",
            "updatedAt": "2025-04-30T12:22:30.426Z",
            "__v": 0
        },
        "webhookMessageAttempt": {
            "awsMessageId": null,
            "headers": [
                {
                    "key": "x-app",
                    "value": "x-value",
                    "_id": "6812160256d753f3b41e1c66"
                },
                {
                    "key": "Content-Type",
                    "value": "application/json",
                    "_id": "6812160256d753f3b41e1c67"
                }
            ],
            "id": "wma_01JT3AC2BWWCWMAWVR7056VNQS",
            "isProcessed": false,
            "isResend": false,
            "response": null,
            "statusCode": null,
            "webhookMessage": "6812160656d753f3b41e1c6a",
            "_id": "6812160656d753f3b41e1c6e",
            "createdAt": "2025-04-30T12:22:30.527Z",
            "updatedAt": "2025-04-30T12:22:30.527Z",
            "__v": 0
        }
    },
    "message": "Webhook message created successfully",
    "success": true
}
POST
/
webhook-messages
curl --request POST \
  --url https://api.us.vartiq.com/webhook-messages \
  --header 'Content-Type: application/json' \
  --header 'companyid: <companyid>' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "appId": "<string>",
  "payload": {}
}'
{
  "success": true,
  "message": "<string>",
  "data": {
    "webhookMessage": {
      "id": "<string>",
      "isDelivered": true,
      "payload": "<string>",
      "signature": "<string>",
      "headers": [
        {}
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>"
    },
    "webhookMessageAttempt": {
      "id": "<string>",
      "isProcessed": true,
      "isResend": true,
      "statusCode": 123,
      "response": "<string>",
      "headers": [
        {}
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  }
}

Headers

companyid
string
required

The unique identifier of your company

Body Parameters

appId
string
required

The unique identifier of the app to send the webhook message to

payload
object
required

The payload to be sent in the webhook message

Response

success
boolean

Indicates if the request was successful

message
string

A message describing the result of the operation

data
object

The created webhook message details

Response Example

{
    "data": {
        "webhookMessage": {
            "headers": [
                {
                    "key": "x-app",
                    "value": "x-value",
                    "_id": "6812160256d753f3b41e1c66"
                },
                {
                    "key": "Content-Type",
                    "value": "application/json",
                    "_id": "6812160256d753f3b41e1c67"
                }
            ],
            "id": "wm_01JT3AC28MCG19W3DP8XG99832",
            "isDelivered": false,
            "payload": "{\"hello\":\"one\"}",
            "signature": "ba245c491633352932de63696a47de3d3da5d75e61b09ecc7614a5979b0db762",
            "webhook": "6812160256d753f3b41e1c65",
            "_id": "6812160656d753f3b41e1c6a",
            "createdAt": "2025-04-30T12:22:30.426Z",
            "updatedAt": "2025-04-30T12:22:30.426Z",
            "__v": 0
        },
        "webhookMessageAttempt": {
            "awsMessageId": null,
            "headers": [
                {
                    "key": "x-app",
                    "value": "x-value",
                    "_id": "6812160256d753f3b41e1c66"
                },
                {
                    "key": "Content-Type",
                    "value": "application/json",
                    "_id": "6812160256d753f3b41e1c67"
                }
            ],
            "id": "wma_01JT3AC2BWWCWMAWVR7056VNQS",
            "isProcessed": false,
            "isResend": false,
            "response": null,
            "statusCode": null,
            "webhookMessage": "6812160656d753f3b41e1c6a",
            "_id": "6812160656d753f3b41e1c6e",
            "createdAt": "2025-04-30T12:22:30.527Z",
            "updatedAt": "2025-04-30T12:22:30.527Z",
            "__v": 0
        }
    },
    "message": "Webhook message created successfully",
    "success": true
}