Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. V1
  5. Account

Account

markdownView as Markdown

Account related resources of the *Lytics API*.

The Account resource describes an account. An account can be a *Master* account, which

means that it is a billing account. Master accounts have children accounts

which act more as separate projects, for same billing account. Each child

account can be used for Dev, Testing, etc., or for separate siloes of data

for sub-divisions, etc..

The Account resource has the following attributes:

| field | DataType | Description |

|-------------|------------------|---------------|

| id | string | unique id

| created | Date | Created date

| updated | Date | Last Updated Date

| domain | string | customer-assigned unique id (auto assigned to domain name). This must be unique across lytics accounts

| email | string | primary email contact for account owner

| parent_id | string | parent account if this account is a child-account of master billing account

| name | string | account name

Retrieve a Single Account

GEThttps://api.lytics.io/api/account/{id}

Get single account by id.

Sample Response
Status|200 OK
12345678910
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "[email protected]",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}

Account Update

PUThttps://api.lytics.io/api/account/{id}

Post update to account. See list of fields above.

Sample Request
123
{
  "name": "updated account name"
}
Sample Response
Status|200 OK
12345678910
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "[email protected]",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}

Accounts List

GEThttps://api.lytics.io/api/account


Sample Response
Status|200 OK
123456789101112131415161718
{
  "status": "success",
  "data": [
    {
      "apikey": "ceHNqmr0ELpNTjRhVg7FFpzM",
      "created": "2014-10-30T21:01:06.493Z",
      "dataapikey": "qQsOcWCe-QipNGC2n5NRVVH7",
      "domain": "example.lytics.io",
      "email": "[email protected]",
      "id": "CNakHAobwEeLuUyrKc5AQTif",
      "name": "Lytics Test",
      "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
      "features": {
        "segment-sizes": true
      }
    }
  ]
}

Account Create

POSThttps://api.lytics.io/api/account

To create a child Account of a parent account, just post:

Sample Request
1234
{
  "name": "String content",
  "domain": "yourdomain.com"
}
Sample Response
Status|201 Created
12345678910
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "[email protected]",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}
Hide Parameters

URL Parameters

idrequiredstring

id of account.

Example:

1234abcd

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

id of account.

Example:

1234abcd

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Body Parameters

nameoptionalstring
Hide Parameters

Headers

Authorizationoptionalstring

Hide Parameters

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Body Parameters

nameoptionalstring
domainoptionalstring