Klaviyo

Klaviyo Accounts API

accounts

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/accounts Get the account for this API key · Get Accounts #
Ask an LLM
“How can I check that my private API key works and which account it belongs to?”
“What timezone and currency is my Klaviyo account set to?”
Tell an agent
Show the account tied to my API key.
Get my account's contact info and timezone using API revision {revision}.
GET /api/accounts/{id} Get an account by its ID · Get Account #
Ask an LLM
“Can I fetch account details when I already know the account ID?”
“Why can I only look up the account my key was generated for?”
Tell an agent
Get account {account_id}.
Show the public API key and settings for account {account_id}.

Documentation

📖
Documentation
https://developers.klaviyo.com/
📖
Authentication
https://developers.klaviyo.com/en/docs/authenticate_
📖
RateLimits
https://developers.klaviyo.com/en/docs/rate_limits_and_error_handling

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-accounts-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/asyncapi/klaviyo-webhooks-asyncapi.yaml

Other Resources

🔗
Reference
https://developers.klaviyo.com/en/reference/api_overview
🔗
Versioning
https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy
🔗
ChangeLog
https://developers.klaviyo.com/en/docs/changelog_
🔗
SDKs
https://developers.klaviyo.com/en/docs/sdk_overview
🔗
GitHub
https://github.com/klaviyo/openapi
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/overlays/klaviyo-accounts-api-overlay.yaml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/klaviyo:klaviyo-accounts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

klaviyo-accounts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Klaviyo Accounts API
  version: '2026-04-15'
  description: The Klaviyo REST API. Please visit https://developers.klaviyo.com for more details.
  contact:
    name: Klaviyo Developer Experience Team
    email: developers@klaviyo.com
    url: https://developers.klaviyo.com
  termsOfService: https://www.klaviyo.com/legal/api-terms
  license:
    name: License
    url: https://www.klaviyo.com/legal
servers:
- url: https://a.klaviyo.com
  description: Production
security:
- Klaviyo-API-Key: []
tags:
- name: Accounts
  description: accounts
paths:
  /api/accounts:
    get:
      operationId: get_accounts
      summary: Get Accounts
      description: 'Retrieve the account(s) associated with a given private API key. This will return 1 account object within the array.


        You can use this to retrieve account-specific data (contact information, timezone, currency, Public API key, etc.) or test if a Private API Key belongs to the correct account prior to performing subsequent actions with the API.


        *Rate limits*:

        Burst: `1/s`

        Steady: `15/m`


        **Scopes:**

        `accounts:read`'
      parameters:
      - name: fields[account]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - contact_information
            - contact_information.default_sender_email
            - contact_information.default_sender_name
            - contact_information.organization_name
            - contact_information.street_address
            - contact_information.street_address.address1
            - contact_information.street_address.address2
            - contact_information.street_address.city
            - contact_information.street_address.country
            - contact_information.street_address.region
            - contact_information.street_address.zip
            - contact_information.website_url
            - industry
            - locale
            - preferred_currency
            - public_api_key
            - test_account
            - timezone
        explode: false
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetAccountResponseCollection'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Accounts
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 1/s
        steady: 15/m
      x-klaviyo-scopes:
      - accounts:read
  /api/accounts/{id}:
    get:
      operationId: get_account
      summary: Get Account
      description: 'Retrieve a single account object by its account ID. You can only request the account by which the private API key was generated.


        *Rate limits*:

        Burst: `1/s`

        Steady: `15/m`


        **Scopes:**

        `accounts:read`'
      parameters:
      - name: id
        in: path
        description: The ID of the account
        required: true
        schema:
          description: The ID of the account
          type: string
          example: AbC123
      - name: fields[account]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - contact_information
            - contact_information.default_sender_email
            - contact_information.default_sender_name
            - contact_information.organization_name
            - contact_information.street_address
            - contact_information.street_address.address1
            - contact_information.street_address.address2
            - contact_information.street_address.city
            - contact_information.street_address.country
            - contact_information.street_address.region
            - contact_information.street_address.zip
            - contact_information.website_url
            - industry
            - locale
            - preferred_currency
            - public_api_key
            - test_account
            - timezone
        explode: false
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetAccountResponse'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Accounts
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 1/s
        steady: 15/m
      x-klaviyo-scopes:
      - accounts:read
components:
  schemas:
    AccountEnum:
      type: string
      enum:
      - account
    StreetAddress:
      type: object
      properties:
        address1:
          type:
          - string
          - 'null'
          example: 125 Summer Street
        address2:
          type:
          - string
          - 'null'
          example: 5th Floor
        city:
          type: string
          example: Boston
        region:
          description: State, province, or region.
          type:
          - string
          - 'null'
          example: MA
        country:
          description: Two-letter [ISO country code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
          type:
          - string
          - 'null'
          example: US
        zip:
          type:
          - string
          - 'null'
          example: '04323'
      required:
      - city
    GetAccountResponseCollection:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/AccountResponseObjectResource'
        links:
          $ref: '#/components/schemas/CollectionLinks'
      required:
      - data
    GetAccountResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/AccountResponseObjectResource'
        links:
          $ref: '#/components/schemas/ObjectLinks'
      required:
      - data
    ContactInformation:
      type: object
      properties:
        default_sender_name:
          description: This field is used to auto-populate the default sender name on flow and campaign emails.
          type: string
          example: Klaviyo Demo
        default_sender_email:
          description: This field is used to auto-populate the default sender email address on flow and campaign emails.
          type: string
          example: contact@klaviyo-demo.com
        website_url:
          type:
          - string
          - 'null'
          example: https://www.klaviyo.com
        organization_name:
          type: string
          example: Klaviyo Demo
        street_address:
          description: Street address for your organization.
          $ref: '#/components/schemas/StreetAddress'
      required:
      - default_sender_name
      - default_sender_email
      - organization_name
      - street_address
    ObjectLinks:
      type: object
      properties:
        self:
          type: string
          format: uri
      required:
      - self
    CollectionLinks:
      type: object
      properties:
        self:
          type: string
          format: uri
        first:
          type: string
          format: uri
        last:
          type: string
          format: uri
        prev:
          type: string
          format: uri
        next:
          type: string
          format: uri
      required:
      - self
    AccountResponseObjectResource:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/AccountEnum'
        id:
          type: string
        attributes:
          type: object
          properties:
            test_account:
              description: Indicates if the account is a test account. Test accounts are not a separate testing engineering environment. Test accounts use the same production environment as normal Klaviyo accounts. This feature is primarily UI based to reduce human errors
              type: boolean
            contact_information:
              description: Contact information for the account. This is used in email footers by default to comply with the CAN-SPAM act.
              $ref: '#/components/schemas/ContactInformation'
            industry:
              description: The kind of business and/or types of goods that the business sells. This is leveraged in Klaviyo analytics and guidance.
              type:
              - string
              - 'null'
              example: Software / SaaS
            timezone:
              description: The account's timezone is used when displaying dates and times. This is an IANA timezone. See [the full list here ](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
              type: string
              example: US/Eastern
            preferred_currency:
              description: The preferred currency for the account. This is the currency used for currency-based metrics in dashboards, analytics, coupons, and templates.
              type: string
              example: USD
            public_api_key:
              description: The Public API Key can be used for client-side API calls. [More info here](https://developers.klaviyo.com/en/docs/retrieve_api_credentials).
              type: string
              example: AbC123
            locale:
              description: The account's locale is used to determine the region and language for the account.
              type: string
              example: en-US
          required:
          - test_account
          - contact_information
          - timezone
          - preferred_currency
          - public_api_key
          - locale
        links:
          $ref: '#/components/schemas/ObjectLinks'
      required:
      - type
      - id
      - attributes
      - links
  responses:
    ServerError:
      description: Server Error
      content:
        application/vnd.api+json:
          schema:
            type: object
            properties:
              errors:
                type: array
                items:
                  type: object
                  required:
                  - id
                  - code
                  - title
                  - detail
                  properties:
                    id:
                      type: string
                    code:
                      type: string
                    title:
                      type: string
                    detail:
                      type: string
                    source:
                      type: object
                      properties:
                        pointer:
                          type: string
                        parameter:
                          type: string
            required:
            - errors
    ClientError:
      description: Client Error
      content:
        application/vnd.api+json:
          schema:
            type: object
            properties:
              errors:
                type: array
                items:
                  type: object
                  required:
                  - id
                  - code
                  - title
                  - detail
                  properties:
                    id:
                      type: string
                    code:
                      type: string
                    title:
                      type: string
                    detail:
                      type: string
                    source:
                      type: object
                      properties:
                        pointer:
                          type: string
                        parameter:
                          type: string
            required:
            - errors
  securitySchemes:
    Klaviyo-API-Key:
      type: apiKey
      in: header
      name: Authorization
      description: Private key authentication for /api/ endpoints is performed by setting the `Authorization` header to `Klaviyo-API-Key your-private-api-key`<br>For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#authentication
      x-default: Klaviyo-API-Key your-private-api-key
x-readme:
  explorer-enabled: false
  proxy-enabled: true
  samples-enabled: true