Skip to main content
POST
/
accounts
Create an account
curl --request POST \
  --url https://api.arcuserp.com/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "<string>",
  "account_type": "business",
  "company_name": "<string>",
  "email": "<string>",
  "phone_main": "<string>",
  "phone_secondary": "<string>",
  "phone_mobile": "<string>",
  "website": "<string>",
  "payment_term_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "credit_limit": 123,
  "tax_exempt": true,
  "avatax_entity_code": "<string>",
  "tax_number": "<string>",
  "default_pricing_level_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "default_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "default_shipping_method": "<string>",
  "notes": "<string>",
  "metadata": {}
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "object": "account",
    "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "display_name": "<string>",
    "company_name": "<string>",
    "account_type": "business",
    "account_number": "<string>",
    "email": "<string>",
    "phone_main": "<string>",
    "phone_secondary": "<string>",
    "phone_mobile": "<string>",
    "website": "<string>",
    "payment_term_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "credit_limit": 123,
    "credit_balance": 123,
    "is_credit_hold": true,
    "tax_exempt": true,
    "avatax_entity_code": "<string>",
    "tax_number": "<string>",
    "default_pricing_level_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "default_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "default_shipping_method": "<string>",
    "shipping_preference": "always_freight",
    "enable_pro_portal": true,
    "is_active": true,
    "notes": "<string>",
    "metadata": {},
    "stripe_customer_id": "<string>",
    "source_platform": "<string>",
    "external_customer_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Headers

​
Idempotency-Key
string

Optional idempotency key for safe retries.

Maximum string length: 255

Body

application/json
​
display_name
string
required
​
account_type
enum<string>
required
Available options:
business,
individual,
lead,
vendor
​
company_name
string | null
​
email
string | null
​
phone_main
string | null
​
phone_secondary
string | null
​
phone_mobile
string | null
​
website
string | null
​
payment_term_id
string<uuid> | null
​
credit_limit
number | null
​
tax_exempt
boolean
​
avatax_entity_code
string | null
​
tax_number
string | null
​
default_pricing_level_id
string<uuid> | null
​
default_location_id
string<uuid> | null
​
default_shipping_method
string | null
​
notes
string | null
​
metadata
object

Response

Account created

​
data
object

An Arcus ERP account. Represents a customer, vendor, lead, or individual. account_type drives AR vs AP behavior: business/individual/lead = customer (AR); vendor = supplier (AP). entity_id is always from the API key (Layer 1 isolation).