POST /v1/inbound/providers/{provider}/{endpoint_id}/{delivery_token}

Family: Provider callback · Operation ID: v1_ingest_provider_outcomes

Access

Provider-to-server delivery. The provider sends its delivery token in the URL and its configured signature. Do not call this from a browser or expose the token in client code.

Open setup and status journey

Replace each {parameter} segment in the path with its URL-encoded value.

Parameters

[
  {
    "description": "sendgrid, ses, mailgun, or postmark",
    "in": "path",
    "name": "provider",
    "required": true,
    "schema": {
      "type": "string"
    }
  },
  {
    "description": "Provider endpoint identifier",
    "in": "path",
    "name": "endpoint_id",
    "required": true,
    "schema": {
      "format": "uuid",
      "type": "string"
    }
  },
  {
    "description": "Secret endpoint delivery token",
    "in": "path",
    "name": "delivery_token",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]

Request body · application/json

{}

Responses

200

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InboundOutcomeResponse"
      }
    }
  },
  "description": "Provider events authenticated and ingested"
}

202

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InboundOutcomeResponse"
      }
    }
  },
  "description": "Receipt retained while endpoint is paused"
}

401

{
  "description": "Provider signature rejected"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract