{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a bulk data source record import job to create a batch of records.\n\nAccepts up to 500 records per request. The maximum allowed payload size is 4MB. The maximum allowed payload size per-record is 512KB.\n\nTo learn more, see our [Custom Objects API overview](https://developers.klaviyo.com/en/reference/custom_objects_api_overview).<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `15/m`\n\n**Scopes:**\n`custom-objects:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/bulk_create_data_source_records.json)","properties":{"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/DataSourceRecordBulkCreateJobCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"DataSourceRecordBulkCreateJobCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/DataSourceRecordBulkCreateJobCreateQueryResourceObject"}},"required":["data"]},"DataSourceRecordBulkCreateJobCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/DataSourceRecordBulkCreateJobEnum"},"attributes":{"type":"object","properties":{"data-source-records":{"description":"The records to ingest.","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/definitions/DataSourceRecordResourceObject"}}},"required":["data"],"examples":[{"data":[{"type":"data-source-record","attributes":{"record":{"object_record":{"subscription_id":"sub-001","service_plan":"Monthly Grooming","visits_per_month":2,"monthly_rate":79.99,"is_active":true,"next_appointment":"2026-08-15T10:00:00Z","pet_id":"pet-001"},"relationships":{"owners":[{"id":"sub-001","email":"alex@example.com","phone":"+15550001000"},{"id":"sub-001","email":"jordan@example.com","phone":"+15550001001"}]}}}}]}]}},"required":["data-source-records"]},"relationships":{"type":"object","properties":{"data-source":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"$ref":"#/definitions/DataSourceEnum"},"id":{"description":"The data source to which the records belong.","type":"string","examples":["01JXKX2HM7NV4QPTR5WE8BF6GY"]}},"required":["type","id"]}}}},"required":["data-source"]}},"required":["type","attributes","relationships"]},"DataSourceRecordBulkCreateJobEnum":{"type":"string","enum":["data-source-record-bulk-create-job"]},"DataSourceRecordResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/DataSourceRecordEnum"},"attributes":{"type":"object","properties":{"record":{"type":"object"}},"required":["record"]}},"required":["type","attributes"]},"DataSourceEnum":{"type":"string","enum":["data-source"]},"DataSourceRecordEnum":{"type":"string","enum":["data-source-record"]}}},"name":"Bulk Create Data Source Records","id":"klaviyo.bulk_create_data_source_records","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"data-source-record-bulk-create-job","attributes":{"data-source-records":{"data":[{"type":"data-source-record","attributes":{"record":{"object_record":{"subscription_id":"sub-001","service_plan":"Monthly Grooming","visits_per_month":2,"monthly_rate":79.99,"is_active":true,"next_appointment":"2026-08-15T10:00:00Z","pet_id":"pet-001"},"relationships":{"owners":[{"id":"sub-001","email":"alex@example.com","phone":"+15550001000"},{"id":"sub-001","email":"jordan@example.com","phone":"+15550001001"}]}}}}]}},"relationships":{"data-source":{}}}}},"maxRequests":1,"summary":false}}