Subscribe to Newsletter
POST/v1/newsletter/subscribe
This endpoint has been deprecated and may be replaced or removed in future versions of the API.
Create a new profile in Klaviyo for newsletter subscription
Request
Responses
- 201
- 400
- 409
- 429
- 500
- 504
OK
The request was rejected. type is invalid_request_error when the request itself is at fault — errors then lists every problem found, with field-attributable entries prefixed by the field’s path; invalid_state_error when the request was well-formed but the resource is not in a state that allows it; or payment_error when the payment was refused by the issuer or processor.
type is conflict_error. The supplied X-Idempotency-Key was already used with a different request body (code is idempotency_conflict, and retrying will not help), or the resource is being modified by another in-flight request (code is resource_locked, and retrying with backoff will).
Too many requests. A limit applies per operation; requests to other operations are unaffected. type is rate_limit_error. Use the Retry-After-global header to know when to retry.
Response Headers
Seconds to wait before retrying.
The request could not be completed because of an unexpected error. type is api_error.
The request exceeded the processing time limit and was abandoned. type is api_error and code is timeout — unlike a plain 500 the request may still have taken effect, so retry with the same idempotency key rather than blindly.