Skip to main content
POST
/
projects
/
{projectId}
/
webhooks
Create webhook subscription
curl --request POST \
  --url https://devtune.ai/api/v2/projects/{projectId}/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "events": []
}
'
{
  "data": {
    "secret": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "url": "<string>",
    "events": [],
    "isActive": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

​
projectId
string<uuid>
required

Body

application/json
​
url
string<uri>
required

URL to POST webhook payloads to

Maximum string length: 2048
​
events
enum<string>[]
required

Event types to subscribe to

Required array length: 1 - 6 elements
Available options:
search-tracking.completed,
visibility.changed,
action.created,
action.updated,
action.recommendation.created,
action.recommendation.updated

Response

Webhook created

​
data
object
​
meta
object