Overview

A "permission" is what a subscriber must consent to in order to be sent an email. In many cases, an account will have a single permission indicating that a subscriber has opted into receiving content from your organisation. In some cases, accounts will have more than one permission. This indicates that there are groups of distinct content, such that a subscriber might have opted in to some of the content but not all of it.

A permission can be associated with many publications, and a publication can be associated with many permissions. Generally the association is simpler, one permission is shared exclusively by multiple publications or one publication is exclusively associated with a single permission.

Subscribers who have opted out of a permission will not be sent emails from publications associated with this permission.

Fields

Example

<permission uri="https://api.newsweaver.com/v2/example-account/permission/My%20Newsletter">
    <name>My Newsletter</name>
    <description>My Newsletter</description>
    <link
        href="https://api.newsweaver.com/v2/example-account/publications?permission=My%20Newsletter"
        rel="http://api-info.newsweaver.com/v2/rels/permission.publications"
        title="Permission (My Newsletter) Publications"/>
    <link
        href="https://api.newsweaver.com/v2/example-account/subscribers?permission=My%20Newsletter"
        rel="http://api-info.newsweaver.com/v2/rels/permission.subscribers"
        title="Permission (My Newsletter) Subscribers"/>
</permission>

See calls:

• List permissions
• Get permission
• Create subscriber permission/association
• Get subscriber/permission association
• Remove subscriber/permission association