Skip to content
/
Get webhook configuration

Seqino PDP API (1.0.0)

Seqino PDP API - Modern interface to France's e-Invoicing services

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL
https://pdp.seqino.dev/
Languages
Servers
Dev server
https://pdp.seqino.dev/api
Local development server
http://localhost:8052

👥 Clients

Operations

📋 Mandates

Operations

📝 Drafts

Operations

📘 Directory

Operations

🧾 Invoicing

Operations

🔄 Lifecycle

Operations

📊 Reporting

Operations

📊 Usage

Operations

⚙️ Settings

Operations

🔔 Webhooks

Operations

Get available webhook event types

Request

Get information about available webhook event types and their payload structures.

This endpoint provides documentation on:

  • All available event types you can subscribe to
  • Example payload structure for each event type
  • Description of what each event represents

Use this information when implementing your webhook endpoint to understand what data you'll receive for each event type.

Note: The example payloads shown here use Pydantic models that enforce type safety and validation (see WEBHOOK_EVENT_METADATA).

Security
APIKeyHeader
curl -i -X GET \
  https://pdp.seqino.dev/api/webhooks/event-types \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

List of available webhook event types

Bodyapplication/json
event_typesArray of objects(Event Types)required

List of available webhook event types

event_types[].​event_typestring(Event Type)required

Event type identifier

Example: "invoice.created"
event_types[].​descriptionstring(Description)required

Human-readable description of the event

Example: "Triggered when a new invoice is created"
event_types[].​example_payloadobject(WebhookEventPayload)required

Example payload structure for this event type

event_types[].​example_payload.​event_idstring(Event Id)required

Unique event identifier

Example: "evt_abc123def456"
event_types[].​example_payload.​event_typestring(WebhookEventType)required

Type of event

Value"invoice.created"
event_types[].​example_payload.​timestampstring(date-time)(Timestamp)required

Event timestamp

event_types[].​example_payload.​sponsor_idstring(Sponsor Id)required

Sponsor ID

Example: "sandbox-sponsor-1"
event_types[].​example_payload.​dataobject(Data)required

Event-specific data

Example: {"file_name":"invoice_2025.xml","invoice_id":"inv_abc123","source_event_id":"inv_abc123","status":"submitted"}
event_types[].​example_payload.​data.​property name*anyadditional property
Response
application/json
{
  "event_types": [
    { … }
  ]
}

Get webhook configuration

Request

Get the current webhook configuration for this sponsor.

Note: The webhook secret is NOT included in this response for security reasons.

Security
APIKeyHeader
curl -i -X GET \
  https://pdp.seqino.dev/api/webhooks \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successful Response

Bodyapplication/json
webhook_idstring(Webhook Id)required

Unique webhook identifier

urlstring(Url)required

Webhook endpoint URL

eventsArray of strings(Events)required

Subscribed event types

is_activeboolean(Is Active)required

Whether the webhook is active

created_atstring(date-time)(Created At)required

Creation timestamp

last_triggered_atLast Triggered At (string) or Last Triggered At (null)(Last Triggered At)

Last time the webhook was triggered

Any of:

Last time the webhook was triggered

string(date-time)(Last Triggered At)
Response
application/json
{
  "webhook_id": "string",
  "url": "string",
  "events": [
    "string"
  ],
  "is_active": true,
  "created_at": "2019-08-24T14:15:22Z",
  "last_triggered_at": "2019-08-24T14:15:22Z"
}

Create webhook endpoint

Request

Create a new webhook for the sponsor.

Only one webhook is allowed per sponsor. The secret is returned only on creation. Store it securely - it cannot be retrieved later.

The secret is used to generate HMAC-SHA256 signatures for webhook payloads.

You can optionally specify which events to subscribe to. If not provided, the webhook will receive all available event types.

Security
APIKeyHeader
Bodyapplication/jsonrequired
urlstring(uri)(Url)[ 1 .. 2083 ] charactersrequired

Webhook endpoint URL (must be HTTPS in production)

Example: "https://api.example.com/webhooks/pdp"
eventsArray of Events (strings) or Events (null)(Events)

List of event types to subscribe to. If not provided, subscribes to all events.

Example: ["invoice.created"]
Any of:

List of event types to subscribe to. If not provided, subscribes to all events.

curl -i -X POST \
  https://pdp.seqino.dev/api/webhooks \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://api.example.com/webhooks/pdp",
    "events": [
      "invoice.created"
    ]
  }'

Responses

Webhook created successfully

Bodyapplication/json
webhook_idstring(Webhook Id)required

Unique webhook identifier

Example: "webhook_abc123def456"
urlstring(Url)required

Webhook endpoint URL

Example: "https://api.example.com/webhooks/pdp"
secretstring(Secret)required

HMAC secret key (only returned once!)

Example: "a1b2c3d4...64char_hex_secret"
eventsArray of strings(Events)required

Subscribed event types

Example: ["invoice.created"]
created_atstring(date-time)(Created At)required

Creation timestamp

messagestring(Message)

Success message

Default "Webhook created successfully"
Response
application/json
{
  "webhook_id": "webhook_abc123def456",
  "url": "https://api.example.com/webhooks/pdp",
  "secret": "a1b2c3d4...64char_hex_secret",
  "events": [
    "invoice.created"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "message": "Webhook created successfully"
}

Delete webhook

Request

Delete the webhook configuration for this sponsor.

Security
APIKeyHeader
curl -i -X DELETE \
  https://pdp.seqino.dev/api/webhooks \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successful Response

Response
No content

Health Check

Request

Health check endpoint.

curl -i -X GET \
  https://pdp.seqino.dev/health

Responses

Successful Response

Bodyapplication/json
any
Response
application/json
null