Read and manage customer profiles with a scoped private API key.
Explore 5 workflow actions for Klaviyo, including account permissions and operation limits.
3 read actions2 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Create or update profile
Write
Create or update a profile by email.
Permissions and limits
Account permissions
profiles:write
Operation limits
Only supplied attributes change on an existing profile. A lost response remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create profile
Write
Create a new profile identified by email.
Permissions and limits
Account permissions
profiles:write
Operation limits
An existing profile may cause a provider conflict. A lost create response remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get accounts
Read
Read the account associated with the private API key.
Permissions and limits
Account permissions
accounts:read
Operation limits
Klaviyo returns one account for a private API key. This endpoint is rate limited to one request per second and fifteen per minute.
Get profile
Read
Read one profile by its Klaviyo ID.
Permissions and limits
Account permissions
profiles:read
List profiles
Read
Read one bounded page of customer profiles.
Permissions and limits
Account permissions
profiles:read
Operation limits
Reads one page of at most 100 profiles. Pass the next cursor from Klaviyo's next-page link to read another page.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Klaviyo. A saved workflow is not a completed provider action.