POST
/
v1
/
targets
/
webhooks
curl --request POST \
  --url https://api.sequin.io/v1/targets/http \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "arakkis_dev",
    "base_url": "https://webhook.site/webhooks",
    "headers": {
      "user-agent": "sequin",
      "authorization": "bearer 8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8"
    },
    "metadata": { "custom_property": 42 }
  }'
{
  "id": "8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8",
  "name": "arakkis_dev",
  "base_url": "https://webhook.site/webhooks",
  "health": {
    "status": "ok",
    "notes": [],
    "time": "2023-12-15 01:29:29"
  },
  "headers": {
    "user-agent": "sequin",
    "authorization": "bearer 8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8"
  },
  "metadata": { "custom_property": 42 },
  "created_at": "2023-12-15 01:29:29",
  "updated_at": "2023-12-15 01:29:29"
}

Request parameters

name
string
required

Name of the target.

base_url
string
required

Base URL of the target. Can include a path.

headers
object

Headers to send to the target. Sequin will include these in every request to the target. Headers are encrypted at rest, so it’s safe to include secrets here.

metadata
object

Metadata for the target. This is a free-form object that you can use to store any additional information you want to associate with the target.

Response fields

id
string

ID of the target.

name
string

Name of the target.

base_url
string

Base URL of the target. Can include a path.

health
object

Health status of the target. Learn more about the health object.

headers
object

Headers to send to the target. Sequin will include these in every request to the target. Headers are encrypted at rest, so it’s safe to include secrets here.

metadata
object

Metadata for the target. This is a free-form object that you can use to store any additional information you want to associate with the target.

created_at
string

Timestamp of when the target was created, in ISO 8601 format.

updated_at
string

Timestamp of when the target was last updated, in ISO 8601 format.