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
- In the app, open Settings, then API keys.
- Create a private key. Choose full access, read-only, or pick the scopes the key needs.
- 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
- Create a profile or create or update one by email.
- Send an event such as an order, so segments, flows and reports can use it.
- Add profiles to a list.
- Read about filtering, pagination and errors before you write a sync.