Flux de relance
Lire vos flux de relance et y inscrire des leads.
Un flux (ou campagne) est une séquence de messages WhatsApp, email ou SMS envoyée automatiquement à un lead. Inscrire un lead par l’API déclenche de vrais envois : c’est pourquoi le scope campaigns:write n’est jamais accordé par défaut.
/campaigns
Lister les flux
GET
/campaigns/:id
Récupérer un flux
POST
/campaigns/:id/enrollments
Inscrire un lead dans un flux
L'objet campaign
| Champ | Type | Description |
|---|---|---|
id
|
uuid | Identifiant du flux. |
name
|
string | Nom. |
flow_type
|
string |
direct_response, click_to_chat, lead_magnet, webinar ou outbound_b2b.
|
status
|
string |
draft, active ou paused.
|
steps
|
array |
Étapes dans l’ordre : order, channel, delay_minutes, content_template.
|
created_at
|
datetime | Date de création. |
Lister les flux
/api/platform/v1/campaigns
campaigns:read
Retourne les flux du compte avec leurs étapes.
Paramètres de requête
| Champ | Type | Description |
|---|---|---|
status
|
string |
draft, active ou paused.
|
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/campaigns' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns', {
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/campaigns",
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/campaigns');
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
{
"object": "list",
"data": [
{
"object": "campaign",
"id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
"name": "Relance Collection d’été",
"flow_type": "direct_response",
"status": "active",
"steps": [
{
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"order": 1,
"channel": "whatsapp",
"delay_minutes": 0,
"content_template": "Bonjour {{first_name}}, merci pour votre intérêt !"
}
],
"created_at": "2026-08-20T12:05:00.000Z",
"updated_at": "2026-09-30T18:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}
Équivalent pour les agents IA : l'outil MCP list_campaigns.
Récupérer un flux
/api/platform/v1/campaigns/:id
campaigns:read
Retourne un flux et ses étapes.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant du flux. |
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54', {
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/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
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/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54');
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
{
"object": "campaign",
"id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
"name": "Relance Collection d’été",
"flow_type": "direct_response",
"status": "active",
"steps": [
{
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"order": 1,
"channel": "whatsapp",
"delay_minutes": 0,
"content_template": "Bonjour {{first_name}}, merci pour votre intérêt !"
}
],
"created_at": "2026-08-20T12:05:00.000Z",
"updated_at": "2026-09-30T18:00:00.000Z"
}
Erreurs spécifiques
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Inscrire un lead dans un flux
/api/platform/v1/campaigns/:id/enrollments
campaigns:write
Démarre le flux pour ce lead : la première étape est planifiée (first_step_at) et les messages partent ensuite automatiquement. Les mêmes règles que dans le dashboard s’appliquent : flux actif et non vide, type de flux et canaux inclus dans votre offre, lead non désinscrit ni bloqué, coordonnée disponible pour le canal de la première étape.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant du flux. |
Corps de la requête (JSON)
| Champ | Type | Description |
|---|---|---|
lead_id
requis
|
uuid | Lead de votre compte à inscrire. |
Exemple de requête
curl -X POST 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments' \
-H "Authorization: Bearer $STRIKE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
}'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
}),
})
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/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments",
headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
},
timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments');
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([
'lead_id' => '8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80',
]),
]);
$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
{
"object": "campaign_enrollment",
"campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
"lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
"status": "scheduled",
"first_step_at": "2026-10-16T10:20:00.000Z"
}
Erreurs spécifiques
not_found).
plan_required) ou canal (channel_not_in_plan) non inclus dans votre offre.
campaign_inactive) ou sans étape (campaign_empty), lead désinscrit ou bloqué (lead_opted_out).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Équivalent pour les agents IA : l'outil MCP enroll_in_campaign.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.