0

Get Forms

by
Published Apr 8, 2025

Get all forms in an account.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms: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 Forms
7
 * Get all forms in an account.*Rate limits*:Burst: `3/s`Steady: `60/m`
8

9
 */
10
export async function main(
11
  auth: Klaviyo,
12
  fields_form_: string | undefined,
13
  filter: string | undefined,
14
  page_cursor_: string | undefined,
15
  page_size_: string | undefined,
16
  sort: "created_at" | "-created_at" | "updated_at" | "-updated_at" | undefined,
17
  revision: string,
18
) {
19
  const url = new URL(`https://a.klaviyo.com/api/forms`);
20
  for (const [k, v] of [
21
    ["fields[form]", fields_form_],
22
    ["filter", filter],
23
    ["page[cursor]", page_cursor_],
24
    ["page[size]", page_size_],
25
    ["sort", sort],
26
  ]) {
27
    if (v !== undefined && v !== "" && k !== undefined) {
28
      url.searchParams.append(k, v);
29
    }
30
  }
31
  const response = await fetch(url, {
32
    method: "GET",
33
    headers: {
34
      revision: revision,
35
      "Accept": "application/vnd.api+json",
36
      Authorization: "Klaviyo-API-Key " + auth.apiKey,
37
    },
38
    body: undefined,
39
  });
40
  if (!response.ok) {
41
    const text = await response.text();
42
    throw new Error(`${response.status} ${text}`);
43
  }
44
  return await response.json();
45
}
46