{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a bulk profile import job to create or update a batch of profiles.\n\nAccepts up to 10,000 profiles per request. The maximum allowed payload size is 5MB. The maximum allowed payload size per-profile is 100KB.\n\nTo learn more, see our [Bulk Profile Import API guide](https://developers.klaviyo.com/en/docs/use_klaviyos_bulk_profile_import_api).<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`lists:write`\n`profiles:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/bulk_import_profiles.json)","properties":{"query":{"type":"object","properties":{"fields[profile-bulk-import-job]":{"type":"array","items":{"type":"string","enum":["completed_at","completed_count","created_at","expires_at","failed_count","id","started_at","status","total_count"]},"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/ProfileImportJobCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"ProfileImportJobCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/ProfileImportJobCreateQueryResourceObject"}},"required":["data"]},"ProfileImportJobCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/ProfileBulkImportJobEnum"},"attributes":{"type":"object","properties":{"profiles":{"description":"Array of profiles to create or update","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/definitions/ProfileUpsertQueryResourceObject"}}},"required":["data"]}},"required":["profiles"]},"relationships":{"type":"object","properties":{"lists":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id"],"properties":{"type":{"$ref":"#/definitions/ListEnum"},"id":{"description":"Optional list to add the profiles to","type":"string","examples":["VRgFBd"]}}}}}}}}},"required":["type","attributes"]},"ProfileBulkImportJobEnum":{"type":"string","enum":["profile-bulk-import-job"]},"ProfileUpsertQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/ProfileEnum"},"id":{"description":"Primary key that uniquely identifies this profile. Generated by Klaviyo.","type":["string","null"]},"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"]},"_kx":{"description":"Also known as the `exchange_id`, this is an encrypted identifier used for identifying a\nprofile by Klaviyo's web tracking.\n\nYou can use this field as a filter when retrieving profiles via the Get Profiles endpoint.","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"}]}}},"meta":{"$ref":"#/definitions/ProfileMeta"}},"required":["type","attributes"]},"ListEnum":{"type":"string","enum":["list"]},"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"]}}},"ProfileMeta":{"type":"object","properties":{"patch_properties":{"$ref":"#/definitions/ProfileMetaPatchProperties"},"patch_identifiers":{"$ref":"#/definitions/PatchIdentifiers"}}},"ProfileMetaPatchProperties":{"type":"object","properties":{"append":{"description":"Append a simple value or values to this property array","type":["object","null"],"examples":[{"skus":"92538"}]},"unappend":{"description":"Remove a simple value or values from this property array","type":["object","null"],"examples":[{"skus":"40571"}]},"unset":{"description":"Remove a key or keys (and their values) completely from properties","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"examples":["skus"]}}},"PatchIdentifiers":{"type":"object","properties":{"append":{"type":"object"},"unappend":{"type":"object"}}}}},"name":"Bulk Import Profiles","id":"klaviyo.bulk_import_profiles","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"profile-bulk-import-job","attributes":{"profiles":{"data":[]}}}}},"maxRequests":1,"summary":false}}