If a profile wants to receive communication regarding a specific topic over a specific channel (email or SMS), they must first give consent. The consent information is saved in APSIS One on a profile level along with the topic and the channel the consent is given for.
The following consent types are supported by APSIS One:
opt-in - profile permits communication
opt-out - profile forbids any communication
pending-opt-in - communication permission waits for the profile to confirm it (not supported by APSIS One API yet)
confirmed-opt-in - profile permits communication which they also confirmed (not supported by APSIS One API yet)
Confirming the consent, also known as double opt-in, is usually done via a link in an email that is sent to the profile.
Create a Consent
Create a profile consent of a specific type regarding a given topic over a selected channel. Provide a reason for consent. Optionally, specify the source of consent which we'll default to One API if not provided.
Profile is identified by keyspace discriminator and profile key. Topic is identified by section discriminator and topic discriminator.
HTTP response status codes specific to this endpoint:
200 - no changes to profile consent were needed
204 - profile consent was changed
409 - transition from current to desired profile consent type is not supported (mostly happens for double opt-in)
Subscribing a Profile to your communication is done in the following order:
Create a profile consent of a specific type regarding a given Subscription/Topic over a selected channel.