Webhooks

Download schema

Event subscriptions and the event log.

List webhook endpoints

GET

https://api.wearenoe.fr/v1

/webhooks

Bearer

Returns the endpoints registered for your integration.

List webhook endpoints › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List webhook endpoints › Responses

Your registered webhook endpoints.

WebhookList

Webhook[] · required

Create a webhook endpoint

POST

https://api.wearenoe.fr/v1

/webhooks

Bearer

Registers an endpoint and returns its signing secret, once. Must be HTTPS and publicly resolvable; private and loopback addresses are rejected. Supported events: reservation.created, reservation.updated, reservation.cancelled, reservation.checkout, block.created, block.updated, block.deleted, calendar.updated, property.updated.

Create a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Create a webhook endpoint › Request Body

CreateWebhookRequest

url

string · required

HTTPS endpoint to deliver to. Must be publicly resolvable.

events

string[] · required

Event types to subscribe to. At least one.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

description

string · maxLength: 200

Your own label for this endpoint.

Create a webhook endpoint › Responses

The created endpoint, including its signing secret. The secret is shown once.

WebhookWithSecret

id

string · uuid · required

object

string · enum · required

Enum values:

webhook_endpoint

url

string · uri · required

events

string[] · required

status

string · enum · required

Enum values:

active

disabled

auto_disabled

description

string | null · required

api_version

string · required

Payload version deliveries to this endpoint are shaped for.

consecutive_failures

number · required

Consecutive delivery failures. Reset by the first success.

last_success_at

string | null · date-time · required

last_failure_at

string | null · date-time · required

disabled_reason

string | null · required

Why Noé disabled the endpoint, when status is auto_disabled.

created_at

string · date-time · required

secret

string · required

Signing secret, returned ONCE at creation and never again. Store it now; verify every delivery with it.

POST/webhooks

curl https://api.wearenoe.fr/v1/webhooks \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 7e1a4c2b-9d3f-4a60-8b71-5c2e9f0a3d84' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "description": "Production sync"
}'

Example Request Body

{
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "description": "Production sync"
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "webhook_endpoint",
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "status": "active",
  "description": "Production listener",
  "api_version": "2026-08-01",
  "consecutive_failures": 0,
  "last_success_at": "2026-08-18T09:31:04Z",
  "last_failure_at": null,
  "disabled_reason": null,
  "created_at": "2026-07-01T10:00:00Z",
  "secret": "whsec_9f2b7c..."
}

json

application/json

Delete a webhook endpoint

DELETE

https://api.wearenoe.fr/v1

/webhooks/{id}

Bearer

Stops delivery immediately. Pending attempts are dropped.

Delete a webhook endpoint › path Parameters

id

string · required

Webhook endpoint id.

Delete a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Delete a webhook endpoint › Responses

Deletion acknowledgement.

Deleted

id

string · uuid · required

object

string · required

deleted

boolean · enum · required

Enum values:

Update a webhook endpoint

PATCH

https://api.wearenoe.fr/v1

/webhooks/{id}

Bearer

Changes the URL, subscribed events or status.

Update a webhook endpoint › path Parameters

id

string · required

Webhook endpoint id.

Update a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Update a webhook endpoint › Request Body

UpdateWebhookRequest

url

string

Replacement HTTPS endpoint.

events

string[]

Replaces the subscription list entirely rather than adding to it.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

description

string · maxLength: 200

Your own label for this endpoint.

status

string · enum

Set to disabled to stop delivery without deleting the endpoint.

Enum values:

active

disabled

Update a webhook endpoint › Responses

The updated endpoint.

Webhook

id

string · uuid · required

object

string · enum · required

Enum values:

webhook_endpoint

url

string · uri · required

events

string[] · required

status

string · enum · required

Enum values:

active

disabled

auto_disabled

description

string | null · required

api_version

string · required

Payload version deliveries to this endpoint are shaped for.

consecutive_failures

number · required

Consecutive delivery failures. Reset by the first success.

last_success_at

string | null · date-time · required

last_failure_at

string | null · date-time · required

disabled_reason

string | null · required

Why Noé disabled the endpoint, when status is auto_disabled.

created_at

string · date-time · required

PATCH/webhooks/{id}

curl https://api.wearenoe.fr/v1/webhooks/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 7e1a4c2b-9d3f-4a60-8b71-5c2e9f0a3d84' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "url": "https://example.com/hooks/noe-v2",
  "events": [
    "reservation.created"
  ],
  "description": "Production sync",
  "status": "active"
}'

Example Request Body

{
  "url": "https://example.com/hooks/noe-v2",
  "events": [
    "reservation.created"
  ],
  "description": "Production sync",
  "status": "active"
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "webhook_endpoint",
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "status": "active",
  "description": "Production listener",
  "api_version": "2026-08-01",
  "consecutive_failures": 0,
  "last_success_at": "2026-08-18T09:31:04Z",
  "last_failure_at": null,
  "disabled_reason": null,
  "created_at": "2026-07-01T10:00:00Z"
}

json

application/json

Rotate a signing secret

POST

https://api.wearenoe.fr/v1

/webhooks/{id}/rotate-secret

Bearer

Returns a new secret. The previous one keeps working for a grace period so you can deploy without downtime.

Rotate a signing secret › path Parameters

id

string · required

Webhook endpoint id.

Rotate a signing secret › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Rotate a signing secret › Responses

The new secret and the grace-window expiry. The old secret verifies until it lapses.

WebhookSecret

id

string · uuid · required

secret

string · required

The new signing secret. Shown once.

previous_secret_valid_until

string · date-time · required

Until when the PREVIOUS secret still verifies, so you can deploy without gaps.

List delivery attempts

GET

https://api.wearenoe.fr/v1

/webhooks/{id}/deliveries

Bearer

Returns recent attempts for one endpoint, newest first, with the response status.

List delivery attempts › path Parameters

id

string · required

Webhook endpoint id.

List delivery attempts › query Parameters

limit

number · min: 1 · max: 200

Maximum attempts to return.

Default: 50

List delivery attempts › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List delivery attempts › Responses

Recent delivery attempts, newest first.

WebhookDeliveryList

WebhookDelivery[] · required

Retry a delivery

POST

https://api.wearenoe.fr/v1

/webhooks/{id}/deliveries/{deliveryId}/retry

Bearer

Queues the delivery for another attempt.

Retry a delivery › path Parameters

id

string · required

Webhook endpoint id.

deliveryId

string · required

Delivery id.

Retry a delivery › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Retry a delivery › Responses

Retry acknowledgement.

No data returned

List events

GET

https://api.wearenoe.fr/v1

/events

Bearer

The durable event log, newest first. Use it to catch up after downtime instead of a full resync.

List events › query Parameters

since

string

Only events created strictly after this timestamp (ISO 8601).

type

string · enum

Only events of this type.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

limit

number · min: 1 · max: 200

Maximum events to return.

Default: 50

List events › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List events › Responses

Events, newest first.

EventList

Event[] · required

Reservations

Noé Public API

Webhooks

Download schema

Event subscriptions and the event log.

List webhook endpoints

GET

https://api.wearenoe.fr/v1

/webhooks

Bearer

Returns the endpoints registered for your integration.

List webhook endpoints › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List webhook endpoints › Responses

Your registered webhook endpoints.

WebhookList

Webhook[] · required

Create a webhook endpoint

POST

https://api.wearenoe.fr/v1

/webhooks

Bearer

Create a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Create a webhook endpoint › Request Body

CreateWebhookRequest

url

string · required

HTTPS endpoint to deliver to. Must be publicly resolvable.

events

string[] · required

Event types to subscribe to. At least one.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

description

string · maxLength: 200

Your own label for this endpoint.

Create a webhook endpoint › Responses

The created endpoint, including its signing secret. The secret is shown once.

WebhookWithSecret

id

string · uuid · required

object

string · enum · required

Enum values:

webhook_endpoint

url

string · uri · required

events

string[] · required

status

string · enum · required

Enum values:

active

disabled

auto_disabled

description

string | null · required

api_version

string · required

Payload version deliveries to this endpoint are shaped for.

consecutive_failures

number · required

Consecutive delivery failures. Reset by the first success.

last_success_at

string | null · date-time · required

last_failure_at

string | null · date-time · required

disabled_reason

string | null · required

Why Noé disabled the endpoint, when status is auto_disabled.

created_at

string · date-time · required

secret

string · required

Signing secret, returned ONCE at creation and never again. Store it now; verify every delivery with it.

POST/webhooks

curl https://api.wearenoe.fr/v1/webhooks \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 7e1a4c2b-9d3f-4a60-8b71-5c2e9f0a3d84' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "description": "Production sync"
}'

Example Request Body

{
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "description": "Production sync"
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "webhook_endpoint",
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "status": "active",
  "description": "Production listener",
  "api_version": "2026-08-01",
  "consecutive_failures": 0,
  "last_success_at": "2026-08-18T09:31:04Z",
  "last_failure_at": null,
  "disabled_reason": null,
  "created_at": "2026-07-01T10:00:00Z",
  "secret": "whsec_9f2b7c..."
}

json

application/json

Delete a webhook endpoint

DELETE

https://api.wearenoe.fr/v1

/webhooks/{id}

Bearer

Stops delivery immediately. Pending attempts are dropped.

Delete a webhook endpoint › path Parameters

id

string · required

Webhook endpoint id.

Delete a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Delete a webhook endpoint › Responses

Deletion acknowledgement.

Deleted

id

string · uuid · required

object

string · required

deleted

boolean · enum · required

Enum values:

Update a webhook endpoint

PATCH

https://api.wearenoe.fr/v1

/webhooks/{id}

Bearer

Changes the URL, subscribed events or status.

Update a webhook endpoint › path Parameters

id

string · required

Webhook endpoint id.

Update a webhook endpoint › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Update a webhook endpoint › Request Body

UpdateWebhookRequest

url

string

Replacement HTTPS endpoint.

events

string[]

Replaces the subscription list entirely rather than adding to it.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

description

string · maxLength: 200

Your own label for this endpoint.

status

string · enum

Set to disabled to stop delivery without deleting the endpoint.

Enum values:

active

disabled

Update a webhook endpoint › Responses

The updated endpoint.

Webhook

id

string · uuid · required

object

string · enum · required

Enum values:

webhook_endpoint

url

string · uri · required

events

string[] · required

status

string · enum · required

Enum values:

active

disabled

auto_disabled

description

string | null · required

api_version

string · required

Payload version deliveries to this endpoint are shaped for.

consecutive_failures

number · required

Consecutive delivery failures. Reset by the first success.

last_success_at

string | null · date-time · required

last_failure_at

string | null · date-time · required

disabled_reason

string | null · required

Why Noé disabled the endpoint, when status is auto_disabled.

created_at

string · date-time · required

PATCH/webhooks/{id}

curl https://api.wearenoe.fr/v1/webhooks/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 7e1a4c2b-9d3f-4a60-8b71-5c2e9f0a3d84' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "url": "https://example.com/hooks/noe-v2",
  "events": [
    "reservation.created"
  ],
  "description": "Production sync",
  "status": "active"
}'

Example Request Body

{
  "url": "https://example.com/hooks/noe-v2",
  "events": [
    "reservation.created"
  ],
  "description": "Production sync",
  "status": "active"
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "webhook_endpoint",
  "url": "https://example.com/hooks/noe",
  "events": [
    "reservation.created",
    "reservation.cancelled"
  ],
  "status": "active",
  "description": "Production listener",
  "api_version": "2026-08-01",
  "consecutive_failures": 0,
  "last_success_at": "2026-08-18T09:31:04Z",
  "last_failure_at": null,
  "disabled_reason": null,
  "created_at": "2026-07-01T10:00:00Z"
}

json

application/json

Rotate a signing secret

POST

https://api.wearenoe.fr/v1

/webhooks/{id}/rotate-secret

Bearer

Returns a new secret. The previous one keeps working for a grace period so you can deploy without downtime.

Rotate a signing secret › path Parameters

id

string · required

Webhook endpoint id.

Rotate a signing secret › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Rotate a signing secret › Responses

The new secret and the grace-window expiry. The old secret verifies until it lapses.

WebhookSecret

id

string · uuid · required

secret

string · required

The new signing secret. Shown once.

previous_secret_valid_until

string · date-time · required

Until when the PREVIOUS secret still verifies, so you can deploy without gaps.

List delivery attempts

GET

https://api.wearenoe.fr/v1

/webhooks/{id}/deliveries

Bearer

Returns recent attempts for one endpoint, newest first, with the response status.

List delivery attempts › path Parameters

id

string · required

Webhook endpoint id.

List delivery attempts › query Parameters

limit

number · min: 1 · max: 200

Maximum attempts to return.

Default: 50

List delivery attempts › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List delivery attempts › Responses

Recent delivery attempts, newest first.

WebhookDeliveryList

WebhookDelivery[] · required

Retry a delivery

POST

https://api.wearenoe.fr/v1

/webhooks/{id}/deliveries/{deliveryId}/retry

Bearer

Queues the delivery for another attempt.

Retry a delivery › path Parameters

id

string · required

Webhook endpoint id.

deliveryId

string · required

Delivery id.

Retry a delivery › Headers

Idempotency-Key

string · required

Any unique string (a UUID works). Retrying with the same key replays the response.

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

Retry a delivery › Responses

Retry acknowledgement.

No data returned

List events

GET

https://api.wearenoe.fr/v1

/events

Bearer

The durable event log, newest first. Use it to catch up after downtime instead of a full resync.

List events › query Parameters

since

string

Only events created strictly after this timestamp (ISO 8601).

type

string · enum

Only events of this type.

Enum values:

reservation.created

reservation.updated

reservation.cancelled

reservation.checkout

block.created

block.updated

block.deleted

calendar.updated

limit

number · min: 1 · max: 200

Maximum events to return.

Default: 50

List events › Headers

X-Noe-App

string

Your integration key. Verified against the key you authenticated with; a mismatch is rejected.

List events › Responses

Events, newest first.

EventList

Event[] · required

Reservations