POST /v1/customers:import
TenantService_ImportCustomers
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
dry_runbooleanenvironment_idstringidempotency_keystringrowsarrayExpand fields
account_typestringcustomer_account_idstringemailstringexternal_refstringidentitiesarrayExpand fields
issuerstringproviderstringrolestringsubjectstring
namestring
cURL
curl --request POST 'https://pay.bytecome.com/v1/customers:import' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"environment_id": "<environment-id>",
"dry_run": true,
"rows": [
{
"external_ref": "<stable-crm-customer-id>",
"name": "<customer-name>",
"account_type": "ENTERPRISE",
"identities": [
{
"provider": "casdoor",
"issuer": "https://identity.example.com",
"subject": "<stable-subject>",
"role": "VIEWER"
}
]
}
]
}'Response contract
200 · OK
bindingsinteger · int32createdinteger · int32customer_account_idsarraydry_runbooleanexistinginteger · int32
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.