Create a Provider
Configures a provider integration from a Courier provider key and its settings. Check the catalog endpoint for the schema each provider expects.
Authorizations
Headers
A unique key that makes this request idempotent. If Courier receives another request with the same Idempotency-Key, it returns the stored response from the first request without performing the operation again (including the original status code and any error). Use it to safely retry POST requests after network failures without risking duplicate sends. The key is scoped to this endpoint.
Body
Request body for creating a new provider configuration.
Provider-specific settings (snake_case keys). Defaults to an empty object when omitted. Use the catalog endpoint to discover required fields for a given provider — omitting a required field returns a 400 validation error. Set rate_limit to cap this configuration's send rate: { "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }, e.g. { "rate": 0.5, "period": "minute" } for one send every 2 minutes. The interval between sends (period divided by rate) must be from 1 millisecond to 12 hours, otherwise the request returns a 400 InvalidRateLimit error. The limit applies per configuration and per environment (a test-environment configuration has its own limit). Sends above the rate are queued, not dropped, and changes take up to 60 seconds to apply. It has no effect on observability or CDP integrations, which do not send messages. Omit it or set it to null for no limit.
Response
Created
A configured provider in the workspace.