Parcours
Lire vos parcours comportementaux et y inscrire des leads.
Un parcours (Journey Builder) enchaîne délais, conditions et actions à partir d’un déclencheur : un événement ou l’entrée dans un segment. L’API permet aussi d’y inscrire un lead directement, par exemple depuis votre back-office.
/journeys
Lister les parcours
GET
/journeys/:id
Récupérer un parcours
POST
/journeys/:id/enrollments
Inscrire un lead dans un parcours
L'objet journey
| Champ | Type | Description |
|---|---|---|
id
|
uuid | Identifiant du parcours. |
name
|
string | Nom. |
status
|
string |
draft, active, paused ou archived.
|
trigger
|
object |
type (event, segment ou null), event, segment_id.
|
entry_policy
|
string |
once (une seule fois par lead) ou multiple.
|
version
|
integer | Version publiée. |
enrollments
|
object |
Uniquement sur GET /journeys/:id : nombre d’inscriptions par statut (active, waiting, completed, failed, exited).
|
Lister les parcours
/api/platform/v1/journeys
journeys:read
Retourne les parcours du compte.
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/journeys' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/journeys', {
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/journeys",
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/journeys');
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": "journey",
"id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
"name": "Panier abandonné",
"status": "active",
"trigger": {
"type": "event",
"event": "checkout_started",
"segment_id": null
},
"entry_policy": "once",
"version": 3,
"activated_at": "2026-09-15T08:00:00.000Z",
"created_at": "2026-09-10T08:00:00.000Z",
"updated_at": "2026-09-15T08:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}
Équivalent pour les agents IA : l'outil MCP list_journeys.
Récupérer un parcours
/api/platform/v1/journeys/:id
journeys:read
Retourne un parcours et ses inscriptions par statut.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant du parcours. |
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15', {
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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15');
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": "journey",
"id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
"name": "Panier abandonné",
"status": "active",
"trigger": {
"type": "event",
"event": "checkout_started",
"segment_id": null
},
"entry_policy": "once",
"version": 3,
"activated_at": "2026-09-15T08:00:00.000Z",
"created_at": "2026-09-10T08:00:00.000Z",
"updated_at": "2026-09-15T08:00:00.000Z",
"enrollments": {
"active": 12,
"waiting": 30,
"completed": 214,
"exited": 3
}
}
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 parcours
/api/platform/v1/journeys/:id/enrollments
journeys:write
Inscrit le lead au début du parcours. Seuls les parcours active acceptent des inscriptions ; la politique d’entrée (once / multiple) est respectée. Émet journey.enrollment.created.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant du parcours. |
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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/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": "journey_enrollment",
"id": "6512bd43-d9ca-4d6e-8a1b-9c2d3e4f5a60",
"journey_id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
"lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
"status": "active",
"current_node_id": "wait-1",
"step": 0,
"started_at": "2026-10-16T10:20:00.000Z",
"completed_at": null
}
Erreurs spécifiques
not_found).
journey_inactive) ou vide (journey_empty), lead déjà passé par le parcours ou en cours (already_enrolled).
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_journey.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.