Endpoints de webhooks

Créer et gérer par l’API les URL qui reçoivent vos événements STRIKE.

Ces endpoints gèrent vos abonnements webhooks par programme ; vous pouvez faire la même chose depuis Développeurs → Webhooks dans le dashboard. Le format des événements, la vérification de signature et la politique de renvoi sont décrits dans le guide Webhooks. Tous ces endpoints exigent le scope webhooks:manage.

L'objet webhook_endpoint

Champ Type Description
id uuid Identifiant de l’endpoint.
url string URL HTTPS publique qui reçoit les événements.
description string | null Libellé libre.
events string[] Types d’événements, ou ["*"] pour tous (sauf event.tracked).
status string active ou disabled.
disabled_reason string | null Raison de la désactivation automatique.
consecutive_failures integer Livraisons consécutives en échec (désactivation à 20).
secret_rotating_until datetime | null Pendant une rotation : fin de validité de l’ancien secret.
last_delivery_at datetime | null Dernière livraison.
secret string Secret de signature whsec_…, retourné uniquement à la création et à la rotation.

Lister les endpoints

GET /api/platform/v1/webhook_endpoints webhooks:manage

Retourne vos endpoints (sans leur secret).

Paramètres de requête

Champ Type Description
limit integer Nombre d’éléments par page, de 1 à 100. Par défaut 25.
cursor string Valeur next_cursor de la page précédente. Voir Pagination.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/webhook_endpoints' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/webhook_endpoints",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "list",
  "data": [
    {
      "object": "webhook_endpoint",
      "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
      "url": "https://crm.example.com/strike/webhooks",
      "description": "Synchronisation CRM",
      "events": [
        "lead.created",
        "lead.updated",
        "payment.succeeded"
      ],
      "status": "active",
      "disabled_reason": null,
      "consecutive_failures": 0,
      "secret_rotating_until": null,
      "last_delivery_at": "2026-10-16T10:05:52.000Z",
      "created_at": "2026-10-16T09:00:00.000Z",
      "updated_at": "2026-10-16T09:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Équivalent pour les agents IA : l'outil MCP list_webhook_endpoints.

Créer un endpoint

POST /api/platform/v1/webhook_endpoints webhooks:manage

Enregistre une URL. La réponse contient le secret de signature : conservez-le immédiatement dans votre gestionnaire de secrets, il ne sera plus jamais affiché.

Corps de la requête (JSON)

Champ Type Description
url requis string URL HTTPS publique, sans identifiants. Refusées : localhost, noms .local / .internal ou sans domaine, adresses IP privées.
events requis string[] 1 à 30 types du catalogue (hors ping), ou ["*"].
description string Libellé libre.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "url": "https://crm.example.com/strike/webhooks",
    "events": [
      "lead.created",
      "lead.updated",
      "payment.succeeded"
    ],
    "description": "Synchronisation CRM"
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "url": "https://crm.example.com/strike/webhooks",
    "events": [
      "lead.created",
      "lead.updated",
      "payment.succeeded"
    ],
    "description": "Synchronisation CRM"
  }),
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import uuid
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/webhook_endpoints",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
        "url": "https://crm.example.com/strike/webhooks",
        "events": ["lead.created", "lead.updated", "payment.succeeded"],
        "description": "Synchronisation CRM",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url' => 'https://crm.example.com/strike/webhooks',
        'events' => ['lead.created', 'lead.updated', 'payment.succeeded'],
        'description' => 'Synchronisation CRM',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 201
{
  "object": "webhook_endpoint",
  "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "url": "https://crm.example.com/strike/webhooks",
  "description": "Synchronisation CRM",
  "events": [
    "lead.created",
    "lead.updated",
    "payment.succeeded"
  ],
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "secret_rotating_until": null,
  "last_delivery_at": "2026-10-16T10:05:52.000Z",
  "created_at": "2026-10-16T09:00:00.000Z",
  "updated_at": "2026-10-16T09:00:00.000Z",
  "secret": "whsec_8Kd2mP4qR7sT9vW1xY3zA5bC6dE8fG0h"
}

Erreurs spécifiques

422 Paramètre invalide (invalid_request) ; param indique le champ en cause.
409 Nombre maximal d’endpoints de votre offre atteint (conflict).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Récupérer un endpoint

GET /api/platform/v1/webhook_endpoints/:id webhooks:manage

Retourne un endpoint (sans son secret).

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_endpoint",
  "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "url": "https://crm.example.com/strike/webhooks",
  "description": "Synchronisation CRM",
  "events": [
    "lead.created",
    "lead.updated",
    "payment.succeeded"
  ],
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "secret_rotating_until": null,
  "last_delivery_at": "2026-10-16T10:05:52.000Z",
  "created_at": "2026-10-16T09:00:00.000Z",
  "updated_at": "2026-10-16T09:00:00.000Z"
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Modifier un endpoint

PATCH /api/platform/v1/webhook_endpoints/:id webhooks:manage

Modifie l’URL, les événements, la description, ou désactive / réactive l’endpoint. Un endpoint désactivé automatiquement se réactive avec "status": "active" (le compteur d’échecs repart de zéro).

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Corps de la requête (JSON)

Champ Type Description
url string Nouvelle URL HTTPS.
events string[] Nouvelle liste d’événements.
description string | null Libellé.
status string active ou disabled.

Exemple de requête

curl -X PATCH 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      "*"
    ],
    "status": "active"
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "events": [
      "*"
    ],
    "status": "active"
  }),
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.patch(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    json={
        "events": ["*"],
        "status": "active",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'events' => ['*'],
        'status' => 'active',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_endpoint",
  "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "url": "https://crm.example.com/strike/webhooks",
  "description": "Synchronisation CRM",
  "events": [
    "*"
  ],
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "secret_rotating_until": null,
  "last_delivery_at": "2026-10-16T10:05:52.000Z",
  "created_at": "2026-10-16T09:00:00.000Z",
  "updated_at": "2026-10-16T09:00:00.000Z"
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).
422 Paramètre invalide (invalid_request) ; param indique le champ en cause.

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Supprimer un endpoint

DELETE /api/platform/v1/webhook_endpoints/:id webhooks:manage

Supprime l’endpoint et son historique de livraisons. Les livraisons en attente sont abandonnées.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Exemple de requête

curl -X DELETE 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
if (!response.ok) throw new Error((await response.json()).error.message)
import os
import requests

response = requests.delete(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_endpoint",
  "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "deleted": true
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Renouveler le secret

POST /api/platform/v1/webhook_endpoints/:id/rotate_secret webhooks:manage

Génère un nouveau secret et le retourne une seule fois. Pendant 24 heures, chaque livraison porte deux signatures v1 (ancien et nouveau secret) : déployez le nouveau secret sans interruption, puis l’ancien cesse d’être utilisé.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_endpoint",
  "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "url": "https://crm.example.com/strike/webhooks",
  "description": "Synchronisation CRM",
  "events": [
    "lead.created",
    "lead.updated",
    "payment.succeeded"
  ],
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "secret_rotating_until": "2026-10-17T10:00:00.000Z",
  "last_delivery_at": "2026-10-16T10:05:52.000Z",
  "created_at": "2026-10-16T09:00:00.000Z",
  "updated_at": "2026-10-16T09:00:00.000Z",
  "secret": "whsec_Q1w2E3r4T5y6U7i8O9p0A1s2D3f4G5h6"
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Envoyer un événement de test

POST /api/platform/v1/webhook_endpoints/:id/test webhooks:manage

Envoie immédiatement un événement ping signé à l’URL (une seule tentative) et retourne la livraison avec la réponse de votre serveur.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_delivery",
  "id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74",
  "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "event_id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG",
  "event_type": "ping",
  "status": "succeeded",
  "attempts": 1,
  "response_status": 200,
  "response_excerpt": "ok",
  "error": null,
  "next_attempt_at": null,
  "delivered_at": "2026-10-16T10:06:00.000Z",
  "created_at": "2026-10-16T10:05:51.000Z",
  "payload": {
    "id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG",
    "object": "event",
    "type": "ping",
    "data": {
      "object": {
        "object": "ping",
        "message": "Ceci est un test envoyé depuis STRIKE.",
        "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12"
      }
    }
  }
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).
409 Endpoint désactivé : réactivez-le avant de le tester (conflict).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Historique des livraisons

GET /api/platform/v1/webhook_endpoints/:id/deliveries webhooks:manage

Retourne les livraisons des 30 derniers jours, de la plus récente à la plus ancienne, avec le code HTTP, un extrait de votre réponse (1 000 caractères max.) et le contenu envoyé (payload).

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de l’endpoint.

Paramètres de requête

Champ Type Description
status string pending, succeeded ou failed.
limit integer Nombre d’éléments par page, de 1 à 100. Par défaut 25.
cursor string Valeur next_cursor de la page précédente. Voir Pagination.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    params={
        "status": "failed",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "list",
  "data": [
    {
      "object": "webhook_delivery",
      "id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74",
      "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
      "event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
      "event_type": "lead.created",
      "status": "pending",
      "attempts": 3,
      "response_status": 503,
      "response_excerpt": "Service Unavailable",
      "error": null,
      "next_attempt_at": "2026-10-16T10:42:00.000Z",
      "delivered_at": null,
      "created_at": "2026-10-16T10:05:51.000Z",
      "payload": {
        "id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
        "object": "event",
        "type": "lead.created",
        "data": {
          "object": {
            "object": "lead",
            "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
          }
        }
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Erreurs spécifiques

404 Endpoint introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Renvoyer une livraison

POST /api/platform/v1/webhook_deliveries/:id/retry webhooks:manage

Crée une nouvelle livraison du même événement (même Strike-Event-Id, nouveau Strike-Delivery-Id) et l’envoie immédiatement. Votre code doit donc dédoublonner sur l’identifiant d’événement.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant de la livraison.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "webhook_delivery",
  "id": "bb43c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d",
  "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
  "event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
  "event_type": "lead.created",
  "status": "pending",
  "attempts": 0,
  "response_status": null,
  "response_excerpt": null,
  "error": null,
  "next_attempt_at": "2026-10-16T10:30:00.000Z",
  "delivered_at": null,
  "created_at": "2026-10-16T10:05:51.000Z",
  "payload": {
    "id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
    "object": "event",
    "type": "lead.created",
    "data": {
      "object": {
        "object": "lead",
        "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
      }
    }
  }
}

Erreurs spécifiques

404 Livraison introuvable, ou appartenant à un autre compte (not_found).
409 Endpoint désactivé (conflict).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Une question sur l'intégration ? Écrivez à contact@strike.app en indiquant l'endpoint, l'heure et le request_id de la réponse.