SendLit logoSendLit Docs
API ReferenceSettingsEspsEspidFeedback

Create or rotate a user ESP's delivery-feedback connection

Creates the connection (and its stable webhook URL) on first call; a later call rotates the credential without changing the URL. The provider is always the ESP's current provider, not client-writable.

PUT
/settings/esps/{espId}/feedback

Creates the connection (and its stable webhook URL) on first call; a later call rotates the credential without changing the URL. The provider is always the ESP's current provider, not client-writable.

Authorization

x-sendlit-apikey<token>

In: header

Path Parameters

espId*string

Request Body

application/json

Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X PUT "https://api.sendlit.dev/settings/esps/string/feedback" \  -H "Content-Type: application/json" \  -d '{    "credential": "string"  }'
{
  "connectionId": "string",
  "espId": "string",
  "provider": "string",
  "webhookUrl": "string",
  "hasCredential": true,
  "status": "pending",
  "lastReceivedAt": "string",
  "lastVerifiedAt": "string",
  "lastErrorCode": "string",
  "createdAt": "string",
  "updatedAt": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}

Get a user ESP's delivery-feedback connection GET

Returns null when feedback hasn't been configured for this ESP yet.

Rotate an existing feedback connection's credential POST

Same effect as PUT, but fails with 404 if no connection exists yet. The previous credential remains valid for 24h so in-flight provider retries aren't lost.