0

Get Campaigns

by
Published Apr 8, 2025

Returns some or all campaigns based on filters. A channel filter is required to list campaigns. Please provide either: `?filter=equals(messages.channel,'email')` to list email campaigns, or `?filter=equals(messages.channel,'sms')` to list SMS campaigns.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Script klaviyo Verified

The script

Submitted by hugo697 Bun
Verified 428 days ago
1
//native
2
type Klaviyo = {
3
  apiKey: string;
4
};
5
/**
6
 * Get Campaigns
7
 * Returns some or all campaigns based on filters.
8

9
A channel filter is required to list campaigns. Please provide either:
10
`?filter=equals(messages.channel,'email')` to list email campaigns, or
11
`?filter=equals(messages.channel,'sms')` to list SMS campaigns.*Rate limits*:Burst: `10/s`Steady: `150/m`
12

13
 */
14
export async function main(
15
  auth: Klaviyo,
16
  filter: string | undefined,
17
  fields_campaign_message_: string | undefined,
18
  fields_campaign_: string | undefined,
19
  fields_tag_: string | undefined,
20
  include: string | undefined,
21
  page_cursor_: string | undefined,
22
  sort:
23
    | "created_at"
24
    | "-created_at"
25
    | "id"
26
    | "-id"
27
    | "name"
28
    | "-name"
29
    | "scheduled_at"
30
    | "-scheduled_at"
31
    | "updated_at"
32
    | "-updated_at"
33
    | undefined,
34
  revision: string,
35
) {
36
  const url = new URL(`https://a.klaviyo.com/api/campaigns`);
37
  for (const [k, v] of [
38
    ["filter", filter],
39
    ["fields[campaign-message]", fields_campaign_message_],
40
    ["fields[campaign]", fields_campaign_],
41
    ["fields[tag]", fields_tag_],
42
    ["include", include],
43
    ["page[cursor]", page_cursor_],
44
    ["sort", sort],
45
  ]) {
46
    if (v !== undefined && v !== "" && k !== undefined) {
47
      url.searchParams.append(k, v);
48
    }
49
  }
50
  const response = await fetch(url, {
51
    method: "GET",
52
    headers: {
53
      revision: revision,
54
      "Accept": "application/vnd.api+json",
55
      Authorization: "Klaviyo-API-Key " + auth.apiKey,
56
    },
57
    body: undefined,
58
  });
59
  if (!response.ok) {
60
    const text = await response.text();
61
    throw new Error(`${response.status} ${text}`);
62
  }
63
  return await response.json();
64
}
65