Skip to main content
POST
/
v1
/
customers
/
batch
Create customers batch
curl --request POST \
  --url https://api.hyperline.co/v1/customers/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customers": [
    {
      "batch_customer_id": "customer-123",
      "name": "Acme",
      "type": "corporate",
      "currency": "EUR",
      "country": "FR",
      "is_government_affiliated": false,
      "vat_number": "FR123456789",
      "vat_rate_custom": 50,
      "registration_number": "36252187900034",
      "external_id": "<string>",
      "invoicing_entity_id": "<string>",
      "billing_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      },
      "shipping_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      },
      "billing_email": "[email protected]",
      "invoice_emails": [
        "[email protected]"
      ],
      "language": "fr",
      "timezone": "Europe/Paris",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "payment_method_type": "card",
      "bank_account": {
        "format": "iban_bic_swift",
        "iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX",
        "bic_swift": "XXXXXXXX"
      },
      "custom_payment_delay": 30,
      "organisation_id": "<string>",
      "organisation_invoicing": "none",
      "properties": {},
      "custom_properties": {},
      "invoice_reminders_enabled": true
    }
  ]
}
'
{
  "successes": [
    {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "type": "corporate",
      "status": "active",
      "currency": "EUR",
      "country": "FR",
      "vat_number": "FR123456789",
      "vat_number_valid": true,
      "vat_rate_custom": null,
      "registration_number": "36252187900034",
      "is_government_affiliated": false,
      "language": "fr",
      "timezone": "Europe/Paris",
      "external_id": null,
      "properties": null,
      "custom_properties": {},
      "billing_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      },
      "shipping_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      },
      "billing_email": "[email protected]",
      "invoice_emails": [
        "[email protected]"
      ],
      "invoicing_entity_id": "ive_484dn4U48E",
      "invoice_reminders_enabled": true,
      "price_book_id": "prib_613_WbVIZ1329e",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "current_payment_method_type": "card",
      "current_payment_method_id": "pm_UTclbc1US8GzCe",
      "custom_payment_delay": 30,
      "subscriptions": [
        {
          "id": "sub_0kIc7jrF7gV00V",
          "status": "active",
          "current_period_started_at": "2024-10-12T07:00:01.860Z",
          "current_period_ends_at": "2024-11-12T07:00:01.860Z",
          "plan_id": "plan_34hdd843hReh",
          "checkout_session_id": "che_949djdj39RJj"
        }
      ],
      "integrations": [
        {
          "entity_id": "123456789",
          "provider_name": "stripe",
          "provider_account_id": "acc_1234567890"
        }
      ],
      "created_at": "2024-10-12T07:00:01.860Z",
      "updated_at": "2024-10-12T07:00:01.860Z",
      "deleted_at": null,
      "providers": {
        "stripe": "<string>",
        "mollie": "<string>",
        "gocardless": "<string>",
        "airwallex": "<string>",
        "salesforce": "<string>",
        "hubspot": "<string>",
        "attio": "<string>",
        "xero": "<string>",
        "pennylane": "<string>",
        "exact-online": "<string>",
        "quickbooks": "<string>",
        "netsuite": "<string>",
        "anrok": "<string>"
      },
      "current_payment_method": {
        "id": "pm_1xMpj5bwRqN7LM",
        "status": "active",
        "type": "card",
        "last_4_digits": 2718,
        "expiration_date": "2027-11",
        "brand": "<string>"
      },
      "bank_account": {
        "format": "iban_bic_swift",
        "iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX",
        "bic_swift": "XXXXXXXX"
      },
      "organisation_id": null,
      "organisation_invoicing": null,
      "batch_customer_id": "customer-123"
    }
  ],
  "errors": [
    {
      "batch_customer_id": "<string>",
      "customer_payload": {
        "name": "Acme",
        "type": "corporate",
        "currency": "EUR",
        "country": "FR",
        "is_government_affiliated": false,
        "vat_number": "FR123456789",
        "vat_rate_custom": 50,
        "registration_number": "36252187900034",
        "external_id": "<string>",
        "invoicing_entity_id": "<string>",
        "billing_address": {
          "name": "Acme",
          "line1": "5 rue de Paradis",
          "line2": null,
          "city": "Paris",
          "zip": "75010",
          "state": "CA",
          "country": "FR"
        },
        "shipping_address": {
          "name": "Acme",
          "line1": "5 rue de Paradis",
          "line2": null,
          "city": "Paris",
          "zip": "75010",
          "state": "CA",
          "country": "FR"
        },
        "billing_email": "[email protected]",
        "invoice_emails": [
          "[email protected]"
        ],
        "language": "fr",
        "timezone": "Europe/Paris",
        "available_payment_methods": [
          "card",
          "direct_debit"
        ],
        "payment_method_type": "card",
        "bank_account": {
          "format": "iban_bic_swift",
          "iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX",
          "bic_swift": "XXXXXXXX"
        },
        "custom_payment_delay": 30,
        "organisation_id": "<string>",
        "organisation_invoicing": "none",
        "properties": {},
        "custom_properties": {},
        "invoice_reminders_enabled": true
      },
      "error": "<unknown>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create customers batch payload

customers
object[]
required
Required array length: 1 - 50 elements

Response

201 - application/json
successes
object[]
required
errors
object[]
required