Content Management API > Session
Create a new session
Warning: Experimental API
Please note that this API method is marked as unstable and should be avoided in production environments. Changes may occur at any time without warning, potentially impacting your scripts. We recommend contacting our Support Team to explore alternative approaches that are safer and more reliable!
Body parameters
type string Required
Must be exactly "email_credentials".
attributes.email string Required
Example:
"foo@bar.com"
attributes.password string Required
Password
Example:
"changeme"
attributes.otp_code string Optional
Two-factor authentication one-time password
Example:
"123512"
Returns
Returns a resource object of type session.
Examples
POST https://site-api.datocms.com/sessions HTTP/1.1Authorization: Bearer YOUR-API-TOKENAccept: application/jsonX-Api-Version: 3Content-Type: application/vnd.api+json
{ "data": { "type": "email_credentials", "attributes": { "email": "foo@bar.com", "password": "changeme" } }}curl -g 'https://site-api.datocms.com/sessions' \ -X POST \ -H "Authorization: Bearer YOUR-API-TOKEN" \ -H "Accept: application/json" \ -H "X-Api-Version: 3" \ -H "Content-Type: application/vnd.api+json" \ --data-binary '{"data":{"type":"email_credentials","attributes":{"email":"foo@bar.com","password":"changeme"}}}'await fetch("https://site-api.datocms.com/sessions", { method: "POST", headers: { Authorization: "Bearer YOUR-API-TOKEN", Accept: "application/json", "X-Api-Version": "3", "Content-Type": "application/vnd.api+json", }, body: JSON.stringify({ data: { type: "email_credentials", attributes: { email: "foo@bar.com", password: "changeme" }, }, }),});HTTP/1.1 200 OKContent-Type: application/jsonCache-Control: cache-control: max-age=0, private, must-revalidateX-RateLimit-Limit: 30X-RateLimit-Remaining: 28
{ "data": { "type": "session", "id": "eyJCJhbGci.eyJhaWwuY29tIn0.32wQOMci", "relationships": { "user": { "data": { "type": "account", "id": "312" } } } }, "included": [ { "type": "user", "id": "312", "relationships": { "role": { "data": { "type": "role", "id": "34" } } }, "attributes": { "email": "mark.smith@example.com", "is_2fa_active": true, "full_name": "Mark Smith", "is_active": true } } ]}