Create Tag

//native

type Klaviyo = {

  apiKey: string;

};

/**

 * Create Tag

 * Create a tag. An account cannot have more than **500** unique tags.

A tag belongs to a single tag group. If the `tag_group_id` is not specified,

the tag is added to the account's default tag group.*Rate limits*:Burst: `3/s`Steady: `60/m`

 */

export async function main(

  auth: Klaviyo,

  revision: string,

  body: {

    data: {

      type: "tag";

      attributes: { name: string };

      relationships?: {

        "tag-group"?: { data?: { type: "tag-group"; id: string } };

      };

    };

  },

) {

  const url = new URL(`https://a.klaviyo.com/api/tags`);

  const response = await fetch(url, {

    method: "POST",

    headers: {

      revision: revision,

      "Accept": "application/vnd.api+json",

      "Content-Type": "application/vnd.api+json",

      Authorization: "Klaviyo-API-Key " + auth.apiKey,

    },

    body: JSON.stringify(body),

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}