Klaviyo

Overview

Use Klaviyo credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	klaviyo
Category	Marketing
Credential Type	API Key

Step 1: Get Credentials

Log in to Klaviyo

Log in to Klaviyo at www.klaviyo.com.

Go to Settings → Account → API Keys

Go to Settings → Account → API Keys at www.klaviyo.com/settings/account/api-keys.

Create a Private API Key

Click ‘Create Private API Key’.

Copy your API key

Copy the generated private API key.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Klaviyo

Go to Managed Secrets > Add Provider > Klaviyo.

Enter credentials

Paste your API Key into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.GET,
    "https://a.klaviyo.com/api/lists",
    grant_id="YOUR_GRANT_ID",
    extra_headers={"revision": "2026-07-15"},
)

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
assign_template_to_campaign_message	send	POST	/api/campaign-message-assign-template
cancel_campaign_send	delete, send	PATCH	/api/campaign-send-jobs/{id}
create_campaign	send	POST	/api/campaigns
create_campaign_clone	send	POST	/api/campaign-clone
send_campaign	send	POST	/api/campaign-send-jobs
update_campaign	send	PATCH	/api/campaigns/{id}
update_campaign_message	send	PATCH	/api/campaign-messages/{id}
update_image_for_campaign_message	send	PATCH	/api/campaign-messages/{id}/relationships/image
bulk_create_coupon_codes	payment	POST	/api/coupon-code-bulk-create-jobs
create_coupon	payment	POST	/api/coupons
create_coupon_code	payment	POST	/api/coupon-codes
delete_coupon	delete, payment	DELETE	/api/coupons/{id}
delete_coupon_code	delete, payment	DELETE	/api/coupon-codes/{id}
update_coupon	payment	PATCH	/api/coupons/{id}
update_coupon_code	payment	PATCH	/api/coupon-codes/{id}
delete_campaign	delete	DELETE	/api/campaigns/{id}
delete_catalog_category	delete	DELETE	/api/catalog-categories/{id}
delete_catalog_item	delete	DELETE	/api/catalog-items/{id}
delete_catalog_variant	delete	DELETE	/api/catalog-variants/{id}
delete_custom_metric	delete	DELETE	/api/custom-metrics/{id}
delete_data_source	delete	DELETE	/api/data-sources/{id}
delete_flow	delete	DELETE	/api/flows/{id}
delete_flow_action	delete	DELETE	/api/flow-actions/{id}
delete_form	delete	DELETE	/api/forms/{id}
delete_list	delete	DELETE	/api/lists/{id}
create_client_push_token	admin, write	POST	/client/push-tokens
create_push_token	admin, write	POST	/api/push-tokens
create_tag_group	admin, write	POST	/api/tag-groups
create_webhook	admin, write	POST	/api/webhooks
update_tag_group	admin, write	PATCH	/api/tag-groups/{id}
add_profiles_to_list	write	POST	/api/lists/{id}/relationships/profiles
bulk_create_catalog_categories	write	POST	/api/catalog-category-bulk-create-jobs
bulk_create_catalog_items	write	POST	/api/catalog-item-bulk-create-jobs
bulk_create_catalog_variants	write	POST	/api/catalog-variant-bulk-create-jobs
bulk_create_client_events	write	POST	/client/event-bulk-create
bulk_create_data_source_records	write	POST	/api/data-source-record-bulk-create-jobs
bulk_create_events	write	POST	/api/event-bulk-create-jobs
update_profile	write	PATCH	/api/profiles/{id}
get_action_for_flow_message	read	GET	/api/flow-messages/{id}/flow-action
get_action_id_for_flow_message	read	GET	/api/flow-messages/{id}/relationships/flow-action
get_bulk_create_catalog_items_job	read	GET	/api/catalog-item-bulk-create-jobs/{job_id}
get_bulk_create_categories_job	read	GET	/api/catalog-category-bulk-create-jobs/{job_id}
get_bulk_create_coupon_codes_job	read	GET	/api/coupon-code-bulk-create-jobs/{job_id}
get_bulk_create_variants_job	read	GET	/api/catalog-variant-bulk-create-jobs/{job_id}