External Customers is a way to grant users access to the content without having made a purchase through the Sesamy Checkout. It can for instance be used to grant the employees and editors access to locked content or to integrate with other Subscription platforms. The External Customers can be accessed in the Sesamy Portal:

The External Customers lists can be creating using different data sources:

Each list has a set of default products that it will grant the users access to.

The API integration makes an outbound HTTP request to validate if a user has access base on their email address. The integrations are unique for each publisher, but typically are setup similar to the sample below:

The header could either be a token signed by our https://tokens.sesamy.com/.well-known/jwks.json keys, a sha256-hmac or a static api key. The response needs to return if the user has access or not, but could also optionally return the customers user-id, the products they have access to and until when they have access:

{
    userId: "1234...",
    entitlements: [{
        id: "entitlementId",
        name: "subscription",
        expiresAt: "2024-06-18T13:59:29.269Z"
    }]
}

Contact support@sesamy.com to add a new API Integration

A product can be setup to validate if a user has access each time they login, which is referred to as Auto Onboarding. This can for instance be used to automatically grant access to existing subscribers when unlocking content in Spotify or when logging in to a website.