Skip to main content

Push registration and topic delivery

Recipient registration and topic membership describe who can receive a notification. Trigger acceptance and provider acknowledgements do not establish arrival.

Device registration presence​

Response conditionInterpretation
A channel omits registered and credentialCountIt has no registered credentials. Check the intended signed-in user and current device token.
remainingCredentialCount is present after removalIts positive value counts credentials still registered for other devices.

Follow enrollment recovery before retrying a test notice. Confirming registration does not establish delivery.

Topic identity and membership results​

FieldMeaning
topicKeyCustomer-chosen identifier used to address the topic.
topicIdOpaque topic reference returned by the API.
isSubscribedOmitted when false.
failed and errorsPer-user membership failures. A partial failure does not fail the whole request.

Topic delivery and retirement​

FieldBehavior
excludeUserIdExcludes one recipient, commonly the person who triggered the event.
acknowledgedIndicates acceptance of the topic send.
statusProvider acknowledgement text, or "done" when the provider supplies none. Do not treat it as a closed set of delivery states.

Deleting a topic returns an operation result in status. Its acknowledgement reports the deletion outcome; provider text defaults to done when no text is supplied. Stop future triggers and handle pending notifications separately when retiring a topic. See delete topic.