TAtalon
Sessions

Create session

[!note] Management API endpoints are not meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Create a session to use the Management API endpoints.

Use the value of the token property provided in the response as bearer token in other API calls.

A token is valid for 3 months. In accordance with best pratices, use your generated token for all your API requests. Do not regenerate a token for each request.

This endpoint has a rate limit of 3 to 6 requests per second per account, depending on your setup.

[!note] Instead of using a session, you can also use the <a href="https://docs.talon.one/docs/product/account/dev-tools/managing-mapi-keys">Management API key feature</a> in the Campaign Manager to decide which endpoints can be used with a given key.

post/v1/sessions

Request

Request body

emailstring email required

The email address associated with the user profile.

passwordstring required

The password for your account.

Example request

{
  "email": "john.doe@example.com",
  "password": "admin123456"
}

Response

Created

userIdinteger required

The ID of the user of this session.

tokenstring required

The token to use as a bearer token to query Management API endpoints.

createdstring date-time required

Unix timestamp indicating when the session was first created.

Example response

{
  "userId": 109,
  "token": "dy_Fa_lQ4iDAnqldJFvVEmnsN8xDTxej19l0LZDBJhQ",
  "created": "2021-07-20T22:00:00Z"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.