Skip to content

Get started

Get started

Create a key and make your first request.

Before you start

You need a Growth Dept Email account and a private API key for it. Every request goes to https://email.growthdept.ai, carries the key in the Authorization header and names the API revision it was written for in the revision header.

1. Create a private key

  1. In the app, open Settings, then API keys.
  2. Create a private key. Choose full access, read-only, or pick the scopes the key needs.
  3. Copy the key when it is shown. It starts with pk_, and the app shows it only once.

Keep private keys on your server

A private key reads and changes your account's data. Store it as a secret in your server or job runner, never in a web page or an app that customers download. Browsers use the account's public key and the client endpoints instead.

2. Make your first call

Get the account is a good first call: it needs only the accounts:read scope and returns the account the key belongs to.

cURL
curl --request GET \
     --url 'https://email.growthdept.ai/api/accounts' \
     --header 'Authorization: Klaviyo-API-Key pk_your_private_key' \
     --header 'accept: application/vnd.api+json' \
     --header 'revision: 2026-10-15'

3. Read the response

Responses are JSON:API documents. A list comes back as a data array of resources, each with a type, an id, attributes and links, plus links for the page. The values below are made up to show the shape.

200 response
{
  "data": [
    {
      "type": "account",
      "id": "R2kX9a",
      "attributes": {
        "test_account": false,
        "contact_information": {
          "default_sender_name": "string",
          "default_sender_email": "string",
          "website_url": "string",
          "organization_name": "string",
          "street_address": {
            "address1": "89 E 42nd St",
            "address2": "Floor 1",
            "city": "New York",
            "region": "NY",
            "country": "United States",
            "zip": "10017"
          }
        },
        "industry": "string",
        "timezone": "America/New_York",
        "preferred_currency": "string",
        "public_api_key": "string",
        "locale": "en-US"
      },
      "links": {
        "self": "https://email.growthdept.ai/api/..."
      }
    }
  ],
  "links": {
    "self": "https://email.growthdept.ai/api/...",
    "prev": "https://email.growthdept.ai/api/...",
    "next": "https://email.growthdept.ai/api/..."
  },
  "meta": {}
}

Next steps