Code App API

The Code App API enables you to manage and distribute codes programmatically on the HORISEN platform. Built as a standard RESTful API and secured with OAuth 2.0, it allows codes to be delivered dynamically as part of campaigns and automated messaging flows.

The API is organized into three resource groups, each scoped under an account: Account for retrieving account data, List for creating and configuring the code lists that group and govern how codes are published, and Code for creating, importing, retrieving, deleting, and publishing the individual codes themselves. Resources are addressed hierarchically as /accounts/{accountUuid}/lists/{listUuid}/codes, so a code always belongs to exactly one list, and a list always belongs to exactly one account.

Access uses the OAuth 2.0 Authorization Code flow: your application redirects the user to the authorization endpoint, exchanges the returned authorization code for an access token, and then sends that token as a Bearer token in the Authorization header of every subsequent call.