{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a new profile.\n\nUse the `additional-fields` parameter to include subscriptions and predictive analytics data in your response.\n\nThe maximum allowed payload size is 100KB.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`profiles:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_profile.json)","properties":{"query":{"type":"object","properties":{"additional-fields[profile]":{"type":"array","items":{"type":"string","enum":["subscriptions","predictive_analytics"]},"description":"Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'"},"fields[profile]":{"type":"array","items":{"type":"string","enum":["created","email","external_id","first_name","id","image","last_event_date","last_name","locale","location","location.address1","location.address2","location.city","location.country","location.ip","location.latitude","location.longitude","location.region","location.timezone","location.zip","organization","phone_number","predictive_analytics","predictive_analytics.average_days_between_orders","predictive_analytics.average_order_value","predictive_analytics.churn_probability","predictive_analytics.expected_date_of_next_order","predictive_analytics.historic_clv","predictive_analytics.historic_number_of_orders","predictive_analytics.predicted_clv","predictive_analytics.predicted_number_of_orders","predictive_analytics.ranked_channel_affinity","predictive_analytics.total_clv","properties","subscriptions","subscriptions.email","subscriptions.email.click_tracking","subscriptions.email.click_tracking.can_receive","subscriptions.email.click_tracking.consent","subscriptions.email.click_tracking.consent_timestamp","subscriptions.email.click_tracking.created_timestamp","subscriptions.email.click_tracking.last_updated","subscriptions.email.click_tracking.metadata","subscriptions.email.click_tracking.valid_until","subscriptions.email.marketing","subscriptions.email.marketing.can_receive_email_marketing","subscriptions.email.marketing.consent","subscriptions.email.marketing.consent_timestamp","subscriptions.email.marketing.custom_method_detail","subscriptions.email.marketing.double_optin","subscriptions.email.marketing.last_updated","subscriptions.email.marketing.list_suppressions","subscriptions.email.marketing.method","subscriptions.email.marketing.method_detail","subscriptions.email.marketing.suppression","subscriptions.email.open_tracking","subscriptions.email.open_tracking.can_receive","subscriptions.email.open_tracking.consent","subscriptions.email.open_tracking.consent_timestamp","subscriptions.email.open_tracking.created_timestamp","subscriptions.email.open_tracking.last_updated","subscriptions.email.open_tracking.metadata","subscriptions.email.open_tracking.valid_until","subscriptions.mobile_push","subscriptions.mobile_push.marketing","subscriptions.mobile_push.marketing.can_receive_push_marketing","subscriptions.mobile_push.marketing.consent","subscriptions.mobile_push.marketing.consent_timestamp","subscriptions.sms","subscriptions.sms.marketing","subscriptions.sms.marketing.can_receive_sms_marketing","subscriptions.sms.marketing.consent","subscriptions.sms.marketing.consent_timestamp","subscriptions.sms.marketing.last_updated","subscriptions.sms.marketing.method","subscriptions.sms.marketing.method_detail","subscriptions.sms.transactional","subscriptions.sms.transactional.can_receive_sms_transactional","subscriptions.sms.transactional.consent","subscriptions.sms.transactional.consent_timestamp","subscriptions.sms.transactional.last_updated","subscriptions.sms.transactional.method","subscriptions.sms.transactional.method_detail","subscriptions.whatsapp","subscriptions.whatsapp.conversational","subscriptions.whatsapp.conversational.can_receive","subscriptions.whatsapp.conversational.consent","subscriptions.whatsapp.conversational.consent_timestamp","subscriptions.whatsapp.conversational.created_timestamp","subscriptions.whatsapp.conversational.last_updated","subscriptions.whatsapp.conversational.metadata","subscriptions.whatsapp.conversational.phone_number","subscriptions.whatsapp.conversational.valid_until","subscriptions.whatsapp.marketing","subscriptions.whatsapp.marketing.can_receive","subscriptions.whatsapp.marketing.consent","subscriptions.whatsapp.marketing.consent_timestamp","subscriptions.whatsapp.marketing.created_timestamp","subscriptions.whatsapp.marketing.last_updated","subscriptions.whatsapp.marketing.metadata","subscriptions.whatsapp.marketing.phone_number","subscriptions.whatsapp.marketing.valid_until","subscriptions.whatsapp.transactional","subscriptions.whatsapp.transactional.can_receive","subscriptions.whatsapp.transactional.consent","subscriptions.whatsapp.transactional.consent_timestamp","subscriptions.whatsapp.transactional.created_timestamp","subscriptions.whatsapp.transactional.last_updated","subscriptions.whatsapp.transactional.metadata","subscriptions.whatsapp.transactional.phone_number","subscriptions.whatsapp.transactional.valid_until","title","updated"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/ProfileCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"ProfileCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/ProfileCreateQueryResourceObject"}},"required":["data"]},"ProfileCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/ProfileEnum"},"attributes":{"type":"object","properties":{"email":{"description":"Individual's email address","type":["string","null"],"examples":["sarah.mason@klaviyo-demo.com"]},"phone_number":{"description":"Individual's phone number in E.164 format","type":["string","null"],"examples":["+15005550006"]},"external_id":{"description":"A unique identifier used by customers to associate Klaviyo profiles with profiles in an external system, such as a point-of-sale system. Format varies based on the external system.","type":["string","null"]},"first_name":{"description":"Individual's first name","type":["string","null"],"examples":["Sarah"]},"last_name":{"description":"Individual's last name","type":["string","null"],"examples":["Mason"]},"organization":{"description":"Name of the company or organization within the company for whom the individual works","type":["string","null"],"examples":["Example Corporation"]},"locale":{"description":"The locale of the profile, in the IETF BCP 47 language tag format like (ISO 639-1/2)-(ISO 3166 alpha-2)","type":["string","null"],"examples":["en-US"]},"title":{"description":"Individual's job title","type":["string","null"],"examples":["Regional Manager"]},"image":{"description":"URL pointing to the location of a profile image","type":["string","null"],"examples":["https://images.pexels.com/photos/3760854/pexels-photo-3760854.jpeg"]},"location":{"$ref":"#/definitions/ProfileLocation"},"properties":{"description":"An object containing key/value pairs for any custom properties assigned to this profile","type":["object","null"],"examples":[{"pseudonym":"Dr. Octopus"}]}}}},"required":["type","attributes"]},"ProfileEnum":{"type":"string","enum":["profile"]},"ProfileLocation":{"type":"object","properties":{"address1":{"description":"First line of street address","type":["string","null"],"examples":["89 E 42nd St"]},"address2":{"description":"Second line of street address","type":["string","null"],"examples":["1st floor"]},"city":{"description":"City name","type":["string","null"],"examples":["New York"]},"country":{"description":"Country name","type":["string","null"],"examples":["United States"]},"latitude":{"description":"Latitude coordinate. We recommend providing a precision of four decimal places.","oneOf":[{"type":"string"},{"type":"number"}],"examples":["40.7128"]},"longitude":{"description":"Longitude coordinate. We recommend providing a precision of four decimal places.","oneOf":[{"type":"string"},{"type":"number"}],"examples":["74.0060"]},"region":{"description":"Region within a country, such as state or province","type":["string","null"],"examples":["NY"]},"zip":{"description":"Zip code","type":["string","null"],"examples":["10017"]},"timezone":{"description":"Time zone name. We recommend using time zones from the IANA Time Zone Database.","type":["string","null"],"examples":["America/New_York"]},"ip":{"description":"IP Address","type":["string","null"],"examples":["127.0.0.1"]}}}}},"name":"Create Profile","id":"klaviyo.create_profile","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"profile","attributes":{}}}},"maxRequests":1,"summary":false}}