Klaviyo Python SDK

These details have not been verified by PyPI

Project links

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Project description

Klaviyo Python SDK

SDK version: 1.0.1
API revision: 2022-10-17

Helpful Resources

Design & Approach

This SDK is a thin wrapper around our API. See our API Reference for full documentation on behavior.

This SDK exactly mirrors the organization and naming convention of the above language-agnostic resources, with a few namespace changes to make it Pythonic (details in Appendix).

Organization

This SDK is organized into the following resources:

Catalogs
Client
Events
Flows
Lists
Metrics
Profiles
Segments
Templates

Installation

You can install this library using our pip package here.

Depending on your system configuration, you will need to run one of the following shell commands:

pip install klaviyo-api

pip3 install klaviyo-api

Usage Example

To instantiate the client

NOTE:

The SDK retries on resolvable errors, namely: rate limits (common) and server errors (rare).
The keyword arguments define some advanced settings; the example is populated with the default values.
max_delay denotes total delay (in seconds) across all attempts.

from klaviyo_api import KlaviyoAPI

klaviyo = KlaviyoAPI("YOUR API KEY HERE", max_delay=60, max_retries=3, test_host=None)

Example request

klaviyo.Metrics.get_metrics()

Error Handling

This SDK throws an ApiException error when the server returns a non-2XX response.

An ApiException consists of the following attributes:

status : int
reason : str

body : bytes

this can be decoded into a native python dictionary as follows:

# to decode to a dictionary
import json
BODY_DICT = json.loads(YOUR_EXCEPTION.body)

# to decode to a string
BODY_STRING = YOUR_EXCEPTION.body.decode('utf-8')

headers : class 'urllib3._collections.HTTPHeaderDict'

This can be interacted with as a normal dictionary:

ex:

date = YOUR_EXCEPTION.headers['Date']
keys = YOUR_EXCEPTION.headers.keys()
values = YOUR_EXCEPTION.headers.values()

Important Notes

The main difference between this SDK and the language-agnostic API Docs that the below endpoints link to is that this SDK automatically adds the revision header corresponding to the SDK version.
Organization: Resource groups and operation_ids are listed below in alphabetical order, first by Resource name, then by OpenAPI Summary. Operation summaries are those listed in the right side bar of the API Reference.
For example values / data types, as well as whether parameters are required/optional, please reference the corresponding API Reference link.
Some keyword args may potentially be required for the API call to succeed, the linked API docs are the source of truth regarding which keyword params are required.
JSON payloads should be passed in as native python dictionaries.
You can override the client private key by passing in an optional api_key keyword arg to any API call that takes a private key. As a reminder: do NOT do this client-side/onsite.

Comprehensive list of Operations & Parameters

Catalogs

Create Catalog Category

## Positional Arguments

# body | dict

klaviyo.Catalogs.create_catalog_category(body);

Create Catalog Category Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.create_catalog_category_relationships(id, related_resource, body);

Create Catalog Item

## Positional Arguments

# body | dict

klaviyo.Catalogs.create_catalog_item(body);

Create Catalog Item Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.create_catalog_item_relationships(id, related_resource, body);

Create Catalog Variant

## Positional Arguments

# body | dict

klaviyo.Catalogs.create_catalog_variant(body);

Delete Catalog Category

## Positional Arguments

# id | str

klaviyo.Catalogs.delete_catalog_category(id);

Delete Catalog Category Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.delete_catalog_category_relationships(id, related_resource, body);

Delete Catalog Item

## Positional Arguments

# id | str

klaviyo.Catalogs.delete_catalog_item(id);

Delete Catalog Item Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.delete_catalog_item_relationships(id, related_resource, body);

Delete Catalog Variant

## Positional Arguments

# id | str

klaviyo.Catalogs.delete_catalog_variant(id);

Get Catalog Categories

## Keyword Arguments

# fields_catalog_category | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_categories(fields_catalog_category=fields_catalog_category, filter=filter, page_cursor=page_cursor, sort=sort);

Get Catalog Category

## Positional Arguments

# id | str

## Keyword Arguments

# fields_catalog_category | [str]

klaviyo.Catalogs.get_catalog_category(id, fields_catalog_category=fields_catalog_category);

Get Catalog Category Items

## Positional Arguments

# category_id | str

## Keyword Arguments

# fields_catalog_item | [str]
# fields_catalog_variant | [str]
# filter | str
# include | [str]
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_category_items(category_id, fields_catalog_item=fields_catalog_item, fields_catalog_variant=fields_catalog_variant, filter=filter, include=include, page_cursor=page_cursor, sort=sort);

Get Catalog Category Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# page_cursor | str

klaviyo.Catalogs.get_catalog_category_relationships(id, related_resource, page_cursor=page_cursor);

Get Catalog Item

## Positional Arguments

# id | str

## Keyword Arguments

# fields_catalog_item | [str]
# fields_catalog_variant | [str]
# include | [str]

klaviyo.Catalogs.get_catalog_item(id, fields_catalog_item=fields_catalog_item, fields_catalog_variant=fields_catalog_variant, include=include);

Get Catalog Item Categories

## Positional Arguments

# item_id | str

## Keyword Arguments

# fields_catalog_category | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_item_categories(item_id, fields_catalog_category=fields_catalog_category, filter=filter, page_cursor=page_cursor, sort=sort);

Get Catalog Item Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# page_cursor | str

klaviyo.Catalogs.get_catalog_item_relationships(id, related_resource, page_cursor=page_cursor);

Get Catalog Item Variants

## Positional Arguments

# item_id | str

## Keyword Arguments

# fields_catalog_variant | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_item_variants(item_id, fields_catalog_variant=fields_catalog_variant, filter=filter, page_cursor=page_cursor, sort=sort);

Get Catalog Items

## Keyword Arguments

# fields_catalog_item | [str]
# fields_catalog_variant | [str]
# filter | str
# include | [str]
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_items(fields_catalog_item=fields_catalog_item, fields_catalog_variant=fields_catalog_variant, filter=filter, include=include, page_cursor=page_cursor, sort=sort);

Get Catalog Variant

## Positional Arguments

# id | str

## Keyword Arguments

# fields_catalog_variant | [str]

klaviyo.Catalogs.get_catalog_variant(id, fields_catalog_variant=fields_catalog_variant);

Get Catalog Variants

## Keyword Arguments

# fields_catalog_variant | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Catalogs.get_catalog_variants(fields_catalog_variant=fields_catalog_variant, filter=filter, page_cursor=page_cursor, sort=sort);

Get Create Categories Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_category_bulk_create_job | [str]
# fields_catalog_category | [str]
# include | [str]

klaviyo.Catalogs.get_create_categories_job(job_id, fields_catalog_category_bulk_create_job=fields_catalog_category_bulk_create_job, fields_catalog_category=fields_catalog_category, include=include);

Get Create Categories Jobs

## Keyword Arguments

# fields_catalog_category_bulk_create_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_create_categories_jobs(fields_catalog_category_bulk_create_job=fields_catalog_category_bulk_create_job, filter=filter, page_cursor=page_cursor);

Get Create Items Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_item_bulk_create_job | [str]
# fields_catalog_item | [str]
# include | [str]

klaviyo.Catalogs.get_create_items_job(job_id, fields_catalog_item_bulk_create_job=fields_catalog_item_bulk_create_job, fields_catalog_item=fields_catalog_item, include=include);

Get Create Items Jobs

## Keyword Arguments

# fields_catalog_item_bulk_create_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_create_items_jobs(fields_catalog_item_bulk_create_job=fields_catalog_item_bulk_create_job, filter=filter, page_cursor=page_cursor);

Get Create Variants Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_variant_bulk_create_job | [str]
# fields_catalog_variant | [str]
# include | [str]

klaviyo.Catalogs.get_create_variants_job(job_id, fields_catalog_variant_bulk_create_job=fields_catalog_variant_bulk_create_job, fields_catalog_variant=fields_catalog_variant, include=include);

Get Create Variants Jobs

## Keyword Arguments

# fields_catalog_variant_bulk_create_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_create_variants_jobs(fields_catalog_variant_bulk_create_job=fields_catalog_variant_bulk_create_job, filter=filter, page_cursor=page_cursor);

Get Delete Categories Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_category_bulk_delete_job | [str]

klaviyo.Catalogs.get_delete_categories_job(job_id, fields_catalog_category_bulk_delete_job=fields_catalog_category_bulk_delete_job);

Get Delete Categories Jobs

## Keyword Arguments

# fields_catalog_category_bulk_delete_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_delete_categories_jobs(fields_catalog_category_bulk_delete_job=fields_catalog_category_bulk_delete_job, filter=filter, page_cursor=page_cursor);

Get Delete Items Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_item_bulk_delete_job | [str]

klaviyo.Catalogs.get_delete_items_job(job_id, fields_catalog_item_bulk_delete_job=fields_catalog_item_bulk_delete_job);

Get Delete Items Jobs

## Keyword Arguments

# fields_catalog_item_bulk_delete_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_delete_items_jobs(fields_catalog_item_bulk_delete_job=fields_catalog_item_bulk_delete_job, filter=filter, page_cursor=page_cursor);

Get Delete Variants Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_variant_bulk_delete_job | [str]

klaviyo.Catalogs.get_delete_variants_job(job_id, fields_catalog_variant_bulk_delete_job=fields_catalog_variant_bulk_delete_job);

Get Delete Variants Jobs

## Keyword Arguments

# fields_catalog_variant_bulk_delete_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_delete_variants_jobs(fields_catalog_variant_bulk_delete_job=fields_catalog_variant_bulk_delete_job, filter=filter, page_cursor=page_cursor);

Get Update Categories Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_category_bulk_update_job | [str]
# fields_catalog_category | [str]
# include | [str]

klaviyo.Catalogs.get_update_categories_job(job_id, fields_catalog_category_bulk_update_job=fields_catalog_category_bulk_update_job, fields_catalog_category=fields_catalog_category, include=include);

Get Update Categories Jobs

## Keyword Arguments

# fields_catalog_category_bulk_update_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_update_categories_jobs(fields_catalog_category_bulk_update_job=fields_catalog_category_bulk_update_job, filter=filter, page_cursor=page_cursor);

Get Update Items Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_item_bulk_update_job | [str]
# fields_catalog_item | [str]
# include | [str]

klaviyo.Catalogs.get_update_items_job(job_id, fields_catalog_item_bulk_update_job=fields_catalog_item_bulk_update_job, fields_catalog_item=fields_catalog_item, include=include);

Get Update Items Jobs

## Keyword Arguments

# fields_catalog_item_bulk_update_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_update_items_jobs(fields_catalog_item_bulk_update_job=fields_catalog_item_bulk_update_job, filter=filter, page_cursor=page_cursor);

Get Update Variants Job

## Positional Arguments

# job_id | str

## Keyword Arguments

# fields_catalog_variant_bulk_update_job | [str]
# fields_catalog_variant | [str]
# include | [str]

klaviyo.Catalogs.get_update_variants_job(job_id, fields_catalog_variant_bulk_update_job=fields_catalog_variant_bulk_update_job, fields_catalog_variant=fields_catalog_variant, include=include);

Get Update Variants Jobs

## Keyword Arguments

# fields_catalog_variant_bulk_update_job | [str]
# filter | str
# page_cursor | str

klaviyo.Catalogs.get_update_variants_jobs(fields_catalog_variant_bulk_update_job=fields_catalog_variant_bulk_update_job, filter=filter, page_cursor=page_cursor);

Spawn Create Categories Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_create_categories_job(body);

Spawn Create Items Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_create_items_job(body);

Spawn Create Variants Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_create_variants_job(body);

Spawn Delete Categories Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_delete_categories_job(body);

Spawn Delete Items Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_delete_items_job(body);

Spawn Delete Variants Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_delete_variants_job(body);

Spawn Update Categories Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_update_categories_job(body);

Spawn Update Items Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_update_items_job(body);

Spawn Update Variants Job

## Positional Arguments

# body | dict

klaviyo.Catalogs.spawn_update_variants_job(body);

Update Catalog Category

## Positional Arguments

# id | str
# body | dict

klaviyo.Catalogs.update_catalog_category(id, body);

Update Catalog Category Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.update_catalog_category_relationships(id, related_resource, body);

Update Catalog Item

## Positional Arguments

# id | str
# body | dict

klaviyo.Catalogs.update_catalog_item(id, body);

Update Catalog Item Relationships

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Catalogs.update_catalog_item_relationships(id, related_resource, body);

Update Catalog Variant

## Positional Arguments

# id | str
# body | dict

klaviyo.Catalogs.update_catalog_variant(id, body);

Client

Create Client Event

## Positional Arguments

# company_id | str
# body | dict

klaviyo.Client.create_client_event(company_id, body);

Create Client Profile

## Positional Arguments

# company_id | str
# body | dict

klaviyo.Client.create_client_profile(company_id, body);

Create Client Subscription

## Positional Arguments

# company_id | str
# body | dict

klaviyo.Client.create_client_subscription(company_id, body);

Events

Create Event

## Positional Arguments

# body | dict

klaviyo.Events.create_event(body);

Get Event

## Positional Arguments

# id | str

## Keyword Arguments

# fields_event | [str]
# fields_metric | [str]
# fields_profile | [str]
# include | [str]

klaviyo.Events.get_event(id, fields_event=fields_event, fields_metric=fields_metric, fields_profile=fields_profile, include=include);

Get Event Metrics

## Positional Arguments

# id | str

## Keyword Arguments

# fields_metric | [str]

klaviyo.Events.get_event_metrics(id, fields_metric=fields_metric);

Get Event Profiles

## Positional Arguments

# id | str

## Keyword Arguments

# fields_profile | [str]

klaviyo.Events.get_event_profiles(id, fields_profile=fields_profile);

Get Event Relationships

## Positional Arguments

# id | str
# related_resource | str

klaviyo.Events.get_event_relationships(id, related_resource);

Get Events

## Keyword Arguments

# fields_event | [str]
# fields_metric | [str]
# fields_profile | [str]
# filter | str
# include | [str]
# page_cursor | str
# sort | str

klaviyo.Events.get_events(fields_event=fields_event, fields_metric=fields_metric, fields_profile=fields_profile, filter=filter, include=include, page_cursor=page_cursor, sort=sort);

Flows

Get Flow

## Positional Arguments

# id | str

## Keyword Arguments

# fields_flow_action | [str]
# fields_flow | [str]
# include | [str]

klaviyo.Flows.get_flow(id, fields_flow_action=fields_flow_action, fields_flow=fields_flow, include=include);

Get Flow Action

## Positional Arguments

# id | str

## Keyword Arguments

# fields_flow_action | [str]
# fields_flow_message | [str]
# fields_flow | [str]
# include | [str]

klaviyo.Flows.get_flow_action(id, fields_flow_action=fields_flow_action, fields_flow_message=fields_flow_message, fields_flow=fields_flow, include=include);

Get Flow For Flow Action

## Positional Arguments

# action_id | str

## Keyword Arguments

# fields_flow | [str]

klaviyo.Flows.get_flow_action_flow(action_id, fields_flow=fields_flow);

Get Messages For Flow Action

## Positional Arguments

# action_id | str

## Keyword Arguments

# fields_flow_message | [str]
# filter | str
# sort | str

klaviyo.Flows.get_flow_action_messages(action_id, fields_flow_message=fields_flow_message, filter=filter, sort=sort);

Get Flow Action Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# filter | str
# sort | str

klaviyo.Flows.get_flow_action_relationships(id, related_resource, filter=filter, sort=sort);

Get Flow Actions For Flow

## Positional Arguments

# flow_id | str

## Keyword Arguments

# fields_flow_action | [str]
# filter | str
# sort | str

klaviyo.Flows.get_flow_flow_actions(flow_id, fields_flow_action=fields_flow_action, filter=filter, sort=sort);

Get Flow Message

## Positional Arguments

# id | str

## Keyword Arguments

# fields_flow_action | [str]
# fields_flow_message | [str]
# include | [str]

klaviyo.Flows.get_flow_message(id, fields_flow_action=fields_flow_action, fields_flow_message=fields_flow_message, include=include);

Get Flow Action For Message

## Positional Arguments

# message_id | str

## Keyword Arguments

# fields_flow_action | [str]

klaviyo.Flows.get_flow_message_action(message_id, fields_flow_action=fields_flow_action);

Get Flow Message Relationships

## Positional Arguments

# id | str
# related_resource | str

klaviyo.Flows.get_flow_message_relationships(id, related_resource);

Get Flow Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# filter | str
# sort | str

klaviyo.Flows.get_flow_relationships(id, related_resource, filter=filter, sort=sort);

Get Flows

## Keyword Arguments

# fields_flow_action | [str]
# fields_flow | [str]
# filter | str
# include | [str]
# sort | str

klaviyo.Flows.get_flows(fields_flow_action=fields_flow_action, fields_flow=fields_flow, filter=filter, include=include, sort=sort);

Update Flow Status

## Positional Arguments

# id | str
# body | dict

klaviyo.Flows.update_flow(id, body);

Lists

Create List

## Positional Arguments

# body | dict

klaviyo.Lists.create_list(body);

Add Profile to List

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Lists.create_list_relationships(id, related_resource, body);

Delete List

## Positional Arguments

# id | str

klaviyo.Lists.delete_list(id);

Remove Profile from List

## Positional Arguments

# id | str
# related_resource | str
# body | dict

klaviyo.Lists.delete_list_relationships(id, related_resource, body);

Get List

## Positional Arguments

# id | str

## Keyword Arguments

# fields_list | [str]

klaviyo.Lists.get_list(id, fields_list=fields_list);

Get List Profiles

## Positional Arguments

# list_id | str

## Keyword Arguments

# fields_profile | [str]
# filter | str
# page_cursor | str

klaviyo.Lists.get_list_profiles(list_id, fields_profile=fields_profile, filter=filter, page_cursor=page_cursor);

Get List Profile Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# page_cursor | str

klaviyo.Lists.get_list_relationships(id, related_resource, page_cursor=page_cursor);

Get Lists

## Keyword Arguments

# fields_list | [str]
# filter | str
# page_cursor | str

klaviyo.Lists.get_lists(fields_list=fields_list, filter=filter, page_cursor=page_cursor);

Update List

## Positional Arguments

# id | str
# body | dict

klaviyo.Lists.update_list(id, body);

Metrics

Get Metric

## Positional Arguments

# id | str

## Keyword Arguments

# fields_metric | [str]

klaviyo.Metrics.get_metric(id, fields_metric=fields_metric);

Get Metrics

## Keyword Arguments

# fields_metric | [str]
# filter | str
# page_cursor | str

klaviyo.Metrics.get_metrics(fields_metric=fields_metric, filter=filter, page_cursor=page_cursor);

Query Metric Aggregates

## Positional Arguments

# body | dict

klaviyo.Metrics.query_metric_aggregates(body);

Profiles

Create Profile

## Positional Arguments

# body | dict

klaviyo.Profiles.create_profile(body);

Get Profile

## Positional Arguments

# id | str

## Keyword Arguments

# fields_list | [str]
# fields_profile | [str]
# fields_segment | [str]
# include | [str]

klaviyo.Profiles.get_profile(id, fields_list=fields_list, fields_profile=fields_profile, fields_segment=fields_segment, include=include);

Get Profile Lists

## Positional Arguments

# profile_id | str

## Keyword Arguments

# fields_list | [str]

klaviyo.Profiles.get_profile_lists(profile_id, fields_list=fields_list);

Get Profile Relationships

## Positional Arguments

# id | str
# related_resource | str

klaviyo.Profiles.get_profile_relationships(id, related_resource);

Get Profile Segments

## Positional Arguments

# profile_id | str

## Keyword Arguments

# fields_segment | [str]

klaviyo.Profiles.get_profile_segments(profile_id, fields_segment=fields_segment);

Get Profiles

## Keyword Arguments

# fields_profile | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Profiles.get_profiles(fields_profile=fields_profile, filter=filter, page_cursor=page_cursor, sort=sort);

Subscribe Profiles

## Positional Arguments

# body | dict

klaviyo.Profiles.subscribe_profiles(body);

Suppress Profiles

## Positional Arguments

# body | dict

klaviyo.Profiles.suppress_profiles(body);

Unsubscribe Profiles

## Positional Arguments

# body | dict

klaviyo.Profiles.unsubscribe_profiles(body);

Unsuppress Profiles

## Positional Arguments

# body | dict

klaviyo.Profiles.unsuppress_profiles(body);

Update Profile

## Positional Arguments

# id | str
# body | dict

klaviyo.Profiles.update_profile(id, body);

Segments

Get Segment

## Positional Arguments

# id | str

## Keyword Arguments

# fields_segment | [str]

klaviyo.Segments.get_segment(id, fields_segment=fields_segment);

Get Segment Profiles

## Positional Arguments

# segment_id | str

## Keyword Arguments

# filter | str
# page_cursor | str

klaviyo.Segments.get_segment_profiles(segment_id, filter=filter, page_cursor=page_cursor);

Get Segment Relationships

## Positional Arguments

# id | str
# related_resource | str

## Keyword Arguments

# page_cursor | str

klaviyo.Segments.get_segment_relationships(id, related_resource, page_cursor=page_cursor);

Get Segments

## Keyword Arguments

# fields_segment | [str]
# filter | str
# page_cursor | str

klaviyo.Segments.get_segments(fields_segment=fields_segment, filter=filter, page_cursor=page_cursor);

Update Segment

## Positional Arguments

# id | str
# body | dict

klaviyo.Segments.update_segment(id, body);

Templates

Create Template

## Positional Arguments

# body | dict

klaviyo.Templates.create_template(body);

Create Template Clone

## Positional Arguments

# id | str
# body | dict

klaviyo.Templates.create_template_clone(id, body);

Create Template Render

## Positional Arguments

# id | str
# body | dict

klaviyo.Templates.create_template_render(id, body);

Delete Template

## Positional Arguments

# id | str

klaviyo.Templates.delete_template(id);

Get Template

## Positional Arguments

# id | str

## Keyword Arguments

# fields_template | [str]

klaviyo.Templates.get_template(id, fields_template=fields_template);

Get Templates

## Keyword Arguments

# fields_template | [str]
# filter | str
# page_cursor | str
# sort | str

klaviyo.Templates.get_templates(fields_template=fields_template, filter=filter, page_cursor=page_cursor, sort=sort);

Update Template

## Positional Arguments

# id | str
# body | dict

klaviyo.Templates.update_template(id, body);

Appendix

Global Keyword Args

NOTE: These are arguments that you can apply to any endpoint call, and which are unique to the SDK

We currently support the following global keyword args:

api_key : use this to override the client-level api_key which you define upon client instantiation

Refresher on catching exceptions:

try:
    YOUR_CALL
except Exception as e:
    print(e.status)
    print(e.reason)
    print(e.body)
    print(e.headers)

Parameters & Arguments

The parameters follow the same naming conventions as the resource groups and operations.

We stick to the following convention for parameters/arguments

All parameters are passed as function args.
All query and path params that are tagged as required in the docs are passed as positional args.
All optional query params are passed as keyword args.
Where applicable, the body param is passed in as a positional arg, and is expected to be a native python dictionary. Within that dictionary, refer to the API docs to see which fields are required/optional, along with valid values.
There is no need to pass in your private api_key for any operations, as it is defined upon client instantiation; public key is still required where applicable. However, you can pass in an optional api_key kwarg to override the client private key for a specific call (REMINDER: don't do this client-side).

Namespace

In the interest of making the SDK Pythonic, we made the following namespace changes relative to the language agnostic resources up top (API Docs, Guides, etc).

Resource names use Pascal case, (e.g. Metrics)
function names and parameter names remain unchanged and use snake case (e.g. get_metrics, and profile_id)

Project details

These details have not been verified by PyPI

Project links

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Release history Release notifications | RSS feed

19.0.2

Jun 18, 2025

19.0.1

Apr 30, 2025

19.0.0

Apr 16, 2025

18.0.0

Feb 21, 2025

17.0.0

Jan 15, 2025

16.0.0

Dec 13, 2024

15.0.0

Nov 19, 2024

14.0.0

Oct 17, 2024

13.0.0

Sep 23, 2024

12.0.0

Aug 29, 2024

11.0.1

Aug 5, 2024

11.0.0

Jul 23, 2024

10.0.0

Jul 15, 2024

9.0.0

Jun 17, 2024

8.0.1

Jun 5, 2024

8.0.0

May 15, 2024

7.0.0

Feb 15, 2024

6.1.0

Dec 15, 2023

6.0.1

Nov 21, 2023

6.0.0

Oct 16, 2023

5.2.0

Sep 15, 2023

5.1.2

Aug 23, 2023

5.1.1

Aug 16, 2023

5.1.0

Aug 15, 2023

5.0.0

Jul 31, 2023

4.0.0

Jul 17, 2023

3.0.0

Jun 15, 2023

2.0.2

Jun 9, 2023

2.0.1

May 30, 2023

2.0.0

Apr 6, 2023

1.3.1

Mar 9, 2023

1.3.0

Mar 1, 2023

1.2.1

Feb 24, 2023

1.2.0

Feb 23, 2023

1.1.0

Jan 25, 2023

1.0.3

Nov 18, 2022

1.0.2

Oct 25, 2022

This version

1.0.1

Oct 20, 2022

1.0.0

Oct 19, 2022

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

klaviyo-api-1.0.1.tar.gz (135.0 kB view details)

Uploaded Oct 20, 2022 Source

Built Distribution

klaviyo_api-1.0.1-py3-none-any.whl (509.2 kB view details)

Uploaded Oct 20, 2022 Python 3

File details

Details for the file klaviyo-api-1.0.1.tar.gz.

File metadata

Download URL: klaviyo-api-1.0.1.tar.gz
Upload date: Oct 20, 2022
Size: 135.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.1 CPython/3.9.12

File hashes

Hashes for klaviyo-api-1.0.1.tar.gz
Algorithm	Hash digest
SHA256	`072d720d9f152838a99728d75f689f844d0c785a2dfebd63d6dfb3913074ec7e`
MD5	`65f0da39af23da8fe049a1df7694e7e5`
BLAKE2b-256	`3fa47aec34375a9d2cd6dfb8c896a250e03bd3527c9e29ff1cf3da2e5e9be372`

See more details on using hashes here.

File details

Details for the file klaviyo_api-1.0.1-py3-none-any.whl.

File metadata

Download URL: klaviyo_api-1.0.1-py3-none-any.whl
Upload date: Oct 20, 2022
Size: 509.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.1 CPython/3.9.12

File hashes

Hashes for klaviyo_api-1.0.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`2ae1c2f20b7e326faa800b4871d426df1331f1ccb34284cf94dd18b573d8f09b`
MD5	`d2391c353385bdbaab96c32e1b31133b`
BLAKE2b-256	`ac0ec2bb06c01a906034b200c780dc37f56d06524d47577fd1c5b92e07f8d2d2`

See more details on using hashes here.

klaviyo-api 1.0.1

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Klaviyo Python SDK

Helpful Resources

Design & Approach

Organization

Installation

Usage Example

To instantiate the client

Example request

Error Handling

Important Notes

Comprehensive list of Operations & Parameters

Catalogs

Client

Events

Flows

Lists

Metrics

Profiles

Segments

Templates

Appendix

Global Keyword Args

Refresher on catching exceptions:

Parameters & Arguments

Namespace

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers