Configure a notification provider
POST/api/v1/notifications/manage/configure-provider
Configures credentials and activation state for a notification provider (e.g., FCM, SendGrid, Twilio).
Uses upsert semantics: if an active integration already exists for the specified provider type, it updates the existing integration in place (preserving its ID and subscriber linkages). If no active integration exists, a new one is created.
The current read-then-upsert path does not establish atomic uniqueness under concurrent configuration. Credentials are sensitive and should stay in trusted backend tooling; the API shape is not proof that they bypass all internal journals or diagnostics.
Provider configuration outcomes
Multiple active integrations of the same type return 409 Conflict and need support resolution. After a credential change, test delivery to an already registered device. Provider status alone does not prove arrival.
Request
Responses
- 200
- 409
Provider configured (created or updated)
Multiple active connections exist for this provider type. Contact your Travila operator to resolve the conflict before retrying.
Document ID: DOC-CP-notifications-api-configureProvider. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-CP-notifications-api-configureProvider#overview |
| Request | DOC-CP-notifications-api-configureProvider#request |
| Responses | DOC-CP-notifications-api-configureProvider#responses |