Create or update (upsert) an account

post

https://core.sivo.com/accounts

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create a account

Creates the account when the id is new, otherwise updates the existing account with the provided fields. Set an optional field to null to clear it.

string

required

length between 1 and 255

The account ID assigned by the originator

name

string

length ≥ 1

Display name of the account. Required at creation unless first_name or last_name is provided, in which case it defaults to them joined; optional for updates.

type

string

enum

Legal classification of the seller entity. Required at creation, optional for updates.

Allowed:

first_name

string | null

First (given) name of an individual

last_name

string | null

Last (family) name of an individual

address

object | null

Primary business address of the seller

shipping

object | null

Delivery address for shipments

website

string | null

^(http:\/\/www\.|https:\/\/www\.|http:\/\/|https:\/\/)?[a-zA-Z0-9]+([-.][a-zA-Z0-9]+)*\.[a-zA-Z]{2,}\/?$

Seller website

string | null

Contact email address for the seller

phone

string | null

Contact phone number for the seller

industry

string | null

^\d{6}$

NAICS industry code: https://www.naics.com/search/

legal_entity_id

^duns:.*$

Legal entity identifier. National schemes must match the address country: ein: and ssn: US, rfc: MX, nit: CO or BO, nif: ES, crn: GB, bn: CA; duns: is valid in any country

DUNS (Data Universal Numbering System) - An 9-digit code with duns: prefix

credit_score

^paydex:.*$

Credit score

Paydex credit score - A 3-digit score with paydex: prefix

kyx_status

string | null

enum

Know Your Customer verification status

Allowed:

active_since

date | null

Date when the seller was first active in the platform

monthly_revenue

integer | null

Monthly revenue of the seller in USD

monthly_costs

integer | null

Monthly costs of the seller in USD

cash_on_hand

integer | null

Cash on hand of the seller in USD

avg_sale_size

integer | null

Average sale size of the seller in USD

performance_score

integer | null

1 to 10

Performance score between 1 (poor) and 10 (excellent)

buyer_concentration

number | null

-10 to 10

Percentage of total revenue from the top 20% of buyers

average_days_to_pay

integer | null

0 to 2147483647

Average days to pay

lifetime_spend

integer | null

Total amount spent by the buyer in USD

customer_count

integer | null

0 to 2147483647

Number of customers

insurance

object | null

Indicates that buyer is insured against non-payment

metadata

object | null

Additional custom data associated with this seller

Headers

IdempotencyKey

string

A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 255 characters. See Idempotent Requests.

Response

200Successful operation