Subscribe a deployment to a mailbox
Subscribes this deployment to a connected Gmail or Outlook mailbox so the provider delivers new-message notifications directly to deliveryUrl (https). Gmail: Khotan registers the mailbox watch and a Pub/Sub push subscription whose pushes carry a Google OIDC token. Outlook: Khotan creates a Microsoft Graph subscription — Graph first validates deliveryUrl by POSTing a validationToken query parameter that the receiver must echo as text/plain within 10 seconds, and every later notification carries the clientState returned here. Secret-bearing and never cached; recover a lost clientState from the client-state endpoint.
Request
- Base URLhttps://app.khotan.com
- URLhttps://app.khotan.com/api/v1/apps/{appId}/email-subscriptions
- Auth
- HTTP bearer
- or API key in header x-api-key
Path parameters
Request body
Response
The created subscription. For Outlook it includes the clientState secret.
Changes
No recorded changes to this operation across all 1 revision of this API.