Skip to main content

bulkCreateCustomers

Create many customers in one asynchronous operation, for instance when loading a tenant's customer list during onboarding.

Business Rules​

  • Each item follows the same rules as createCustomer.
  • Items that fail validation are skipped and reported; the rest are still created.

Process Tracking​

Use the response processId with the processStatus query or processStatusSubscription subscription. Progress, per-item failures, and counts are reported in the metadata.

Error Scenarios​

  • **Validation Error**: the request carries more customers than the per-request maximum.
  • A failing item does not fail the request; its reason is reported in the process metadata.

Permissions Required​

  • customers:create_customer permission, enforced per item.
bulkCreateCustomers(
  input: BulkCreateCustomersInput!
): AsynchronousActionResponse!

Arguments​

bulkCreateCustomers.input ● BulkCreateCustomersInput! non-null input common​

Parameters for BulkCreateCustomers

Type​

AsynchronousActionResponse object common​

Asynchronous action response type