Webhook endpoints

Endpoints

POST/v1/webhook_endpoints
PATCH/v1/webhook_endpoints/{endpoint}
GET/v1/webhook_endpoints/{endpoint}
GET/v1/webhook_endpoints
DELETE/v1/webhook_endpoints/{endpoint}

L’objet Webhook endpoint

Attributs

idstring
Identifiant unique de l'objet (préfixé, opaque).
objectstring
webhook_endpoint
urlstring
descriptionstringnullable
enabled_eventsarray of string
brandsarray of objectnullable
statusenum
Valeurs possibles : enabled · disabled
api_versionstring
livemodeboolean
true pour les données réelles, false pour le bac à sable du mode test.
createdinteger
Time at which the object was created (unix timestamp, seconds).
secretstring

L'objet Webhook endpoint


{
  "id": "we_034eTM6NVwPXgyvF595hZZ",
  "object": "webhook_endpoint",
  "url": "https://hooks.example.com/skoup",
  "description": "Rewrite the product copy so the frame warranty is stated.",
  "enabled_events": [
    "string"
  ],
  "brands": [
    {}
  ],
  "status": "enabled",
  "api_version": "v1",
  "livemode": true,
  "created": 1790000000,
  "secret": "whsec_9fW2kLq7Rt4mXz1Vb8Nc3Hy6"
}

Create a webhook endpoint

POST/v1/webhook_endpoints

The response carries the signing secret (whsec_…) — the only time the API returns it. Store it to verify the X-Skoup-Signature header.

Paramètres

urlstringobligatoire
descriptionstringnullable
enabled_eventsarray of stringobligatoire
brandsarray of stringnullable
disabledboolean

Retour

Renvoie l’objet webhook_endpoint créé. Lève une erreur en cas de problème.

curl


curl -X POST https://api.skoup.ai/v1/webhook_endpoints \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://nordvelo.fr","enabled_events":["string"],"description":"Rewrite the product copy so the frame warranty is stated."}'

Node.js


const response = await fetch('https://api.skoup.ai/v1/webhook_endpoints', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"url":"https://nordvelo.fr","enabled_events":["string"],"description":"Rewrite the product copy so the frame warranty is stated."}),
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('POST', 'webhook_endpoints', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
    'json' => ['url' => 'https://nordvelo.fr', 'enabled_events' => ['string'], 'description' => 'Rewrite the product copy so the frame warranty is stated.'],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.post(
    "https://api.skoup.ai/v1/webhook_endpoints",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
    json={"url": "https://nordvelo.fr", "enabled_events": ["string"], "description": "Rewrite the product copy so the frame warranty is stated."},
)
data = response.json()

Réponse


{
  "id": "we_034eTM6NVwPXgyvF595hZZ",
  "object": "webhook_endpoint",
  "url": "https://hooks.example.com/skoup",
  "description": "Rewrite the product copy so the frame warranty is stated.",
  "enabled_events": [
    "string"
  ],
  "brands": [
    {}
  ],
  "status": "enabled",
  "api_version": "v1",
  "livemode": true,
  "created": 1790000000,
  "secret": "whsec_9fW2kLq7Rt4mXz1Vb8Nc3Hy6"
}

Update a webhook endpoint

PATCH/v1/webhook_endpoints/{endpoint}

Send disabled: true to pause it, false to enable it again.

Paramètres

endpointstringobligatoire
Webhook Endpoint id (we_…).
urlstringobligatoire
descriptionstringnullable
enabled_eventsarray of stringobligatoire
brandsarray of stringnullable
disabledboolean

Retour

Renvoie l’objet webhook_endpoint mis à jour. Lève une erreur en cas de problème.

curl


curl -X PATCH https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://nordvelo.fr","enabled_events":["string"],"description":"Rewrite the product copy so the frame warranty is stated."}'

Node.js


const response = await fetch('https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"url":"https://nordvelo.fr","enabled_events":["string"],"description":"Rewrite the product copy so the frame warranty is stated."}),
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('PATCH', 'webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
    'json' => ['url' => 'https://nordvelo.fr', 'enabled_events' => ['string'], 'description' => 'Rewrite the product copy so the frame warranty is stated.'],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.patch(
    "https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
    json={"url": "https://nordvelo.fr", "enabled_events": ["string"], "description": "Rewrite the product copy so the frame warranty is stated."},
)
data = response.json()

Réponse


{
  "id": "we_034eTM6NVwPXgyvF595hZZ",
  "object": "webhook_endpoint",
  "url": "https://hooks.example.com/skoup",
  "description": "Rewrite the product copy so the frame warranty is stated.",
  "enabled_events": [
    "string"
  ],
  "brands": [
    {}
  ],
  "status": "enabled",
  "api_version": "v1",
  "livemode": true,
  "created": 1790000000,
  "secret": "whsec_9fW2kLq7Rt4mXz1Vb8Nc3Hy6"
}

Retrieve a webhook endpoint

GET/v1/webhook_endpoints/{endpoint}

Paramètres

endpointstringobligatoire
Webhook Endpoint id (we_…).

Retour

Renvoie l’objet webhook_endpoint. Lève une erreur en cas de problème.

curl


curl https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Node.js


const response = await fetch('https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
  },
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('GET', 'webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.get(
    "https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
)
data = response.json()

Réponse


{
  "id": "we_034eTM6NVwPXgyvF595hZZ",
  "object": "webhook_endpoint",
  "url": "https://hooks.example.com/skoup",
  "description": "Rewrite the product copy so the frame warranty is stated.",
  "enabled_events": [
    "string"
  ],
  "brands": [
    {}
  ],
  "status": "enabled",
  "api_version": "v1",
  "livemode": true,
  "created": 1790000000,
  "secret": "whsec_9fW2kLq7Rt4mXz1Vb8Nc3Hy6"
}

List webhook endpoints

GET/v1/webhook_endpoints

Paramètres

limitinteger
Nombre d'objets à renvoyer, entre 1 et 100 (20 par défaut).
starting_afterstring
Curseur : l'id du dernier objet de la page précédente.

Retour

Un dictionnaire dont la propriété data contient jusqu’à limit objets webhook_endpoint, du plus récent au plus ancien, et has_more indique s’il reste une page. Lève une erreur en cas de problème.

curl


curl https://api.skoup.ai/v1/webhook_endpoints?limit=3 \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Node.js


const response = await fetch('https://api.skoup.ai/v1/webhook_endpoints?limit=3', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
  },
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('GET', 'webhook_endpoints?limit=3', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.get(
    "https://api.skoup.ai/v1/webhook_endpoints?limit=3",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
)
data = response.json()

Réponse


{
  "object": "list",
  "url": "/v1/webhook_endpoints",
  "has_more": false,
  "data": [
    {
      "id": "we_034eTM6NVwPXgyvF595hZZ",
      "object": "webhook_endpoint",
      "url": "https://hooks.example.com/skoup",
      "description": "Rewrite the product copy so the frame warranty is stated.",
      "enabled_events": [
        "string"
      ],
      "brands": [
        {}
      ],
      "status": "enabled",
      "api_version": "v1",
      "livemode": true,
      "created": 1790000000,
      "secret": "whsec_9fW2kLq7Rt4mXz1Vb8Nc3Hy6"
    }
  ]
}

Delete a webhook endpoint

DELETE/v1/webhook_endpoints/{endpoint}

Paramètres

endpointstringobligatoire
Webhook Endpoint id (we_…).

Retour

Renvoie un objet avec deleted: true. Lève une erreur en cas de problème.

curl


curl -X DELETE https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Node.js


const response = await fetch('https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
  },
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('DELETE', 'webhook_endpoints/we_034ebikiyFV76y9oiMvhxm', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.delete(
    "https://api.skoup.ai/v1/webhook_endpoints/we_034ebikiyFV76y9oiMvhxm",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
)
data = response.json()

Réponse


{
  "id": "we_034ebikiyFV76y9oiMvhxm",
  "object": "webhook_endpoint",
  "deleted": true
}