Accounting Classification1

Addresses5

Authentication2

Auto-Transfer Presets5

Autotags5

Business Trips9

Card Rules12

Card Rules Presets5

Cards6

Company1

Contacts5

Documents5

Expense Categories4

Expense Policies7

Expense Reports5

Expense Review Configuration3

Expense Review Processes8

Expense Reviews7

Groups7

Lists5

Online Ads8

Orders3

Out of Office5

Permissions1

Pre-approved Spend6

Refueling Transactions3

Requests7

Resource Sets5

Statements2

Subscriptions8

Tags7

Transaction Attachments6

Transaction Custom Export4

Transaction Expense Category2

Transaction Hotel Metadata2

Transaction Metadata5

Transaction Split3

Transaction Tags2

Transaction VAT Rate1

Transactions12

User Roles3

Users8

VAT Rates5

Vehicles5

Wallets7

Webhook Subscriptions5

Workflows6

Webhooks

Webhooks87

Addresses

Add Address

Changed on Aug 6, 2026

Endpoint to create an Address.

post/business/v2/addresses

Request

Base URL
https://api.soldo.com
Auth
OAuth 2
Client credentials
Token URLhttps://api.soldo.com/oauth/authorize
Scopesaddress_write
TypeScript
https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/docs/business/v2/addresses/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

X-Soldo-Fingerprintstring required

Advanced authentication: SHA512SUM of the fingerprint values listed in the fingerprint order for this endpoint.

Example:{{fingerprint}}

X-Soldo-Fingerprint-Signaturestring required

Advanced authentication: Signature of the X-Soldo-Fingerprint.

Example:{{fingerprint_signature}}

Request body

recipientstring

The recipient of the addressee.

namestring required

The actual name of the Address.

line1string required

The primary street of the Address.

line2string

The optional secondary street.

country'ASC' | 'AND' | 'ARE' | 'AFG' | 'ATG' | 'AIA' | 'ALB' | 'ARM' | 'ANT' | 'AGO' | 'ATA' | 'ARG' | 'ASM' | 'AUT' | 'AUS' | 'ABW' | 'ALA' | 'AZE' | 'BIH' | 'BRB' | 'BGD' | 'BEL' | 'BFA' | 'BGR' | 'BHR' | 'BDI' | 'BEN' | 'BLM' | 'BMU' | 'BRN' | 'BOL' | 'BES' | 'BRA' | 'BHS' | 'BTN' | 'BUR' | 'BVT' | 'BWA' | 'BLR' | 'BLZ' | 'CAN' | 'CCK' | 'COD' | 'CAF' | 'COG' | 'CHE' | 'CIV' | 'COK' | 'CHL' | 'CMR' | 'CHN' | 'COL' | 'CPT' | 'CRI' | 'CSXX' | 'CUB' | 'CPV' | 'CUW' | 'CXR' | 'CYP' | 'CZE' | 'DEU' | 'DGA' | 'DJI' | 'DNK' | 'DMA' | 'DOM' | 'DZA' | 'ECU' | 'EST' | 'EGY' | 'ESH' | 'ERI' | 'ESP' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FSM' | 'FRO' | 'FRA' | 'FXX' | 'GAB' | 'GBR' | 'GRD' | 'GEO' | 'GUF' | 'GGY' | 'GHA' | 'GIB' | 'GRL' | 'GMB' | 'GIN' | 'GLP' | 'GNQ' | 'GRC' | 'SGS' | 'GTM' | 'GUM' | 'GNB' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IRL' | 'ISR' | 'IMN' | 'IND' | 'IOT' | 'IRQ' | 'IRN' | 'ISL' | 'ITA' | 'JEY' | 'JAM' | 'JOR' | 'JPN' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'COM' | 'KNA' | 'PRK' | 'KOR' | 'KWT' | 'CYM' | 'KAZ' | 'LAO' | 'LBN' | 'LCA' | 'LIE' | 'LKA' | 'LBR' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'LBY' | 'MAR' | 'MCO' | 'MDA' | 'MNE' | 'MAF' | 'MDG' | 'MHL' | 'MKD' | 'MLI' | 'MMR' | 'MNG' | 'MAC' | 'MNP' | 'MTQ' | 'MRT' | 'MSR' | 'MLT' | 'MUS' | 'MDV' | 'MWI' | 'MEX' | 'MYS' | 'MOZ' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NTZ' | 'NIU' | 'NZL' | 'OMN' | 'PAN' | 'PER' | 'PYF' | 'PNG' | 'PHL' | 'PAK' | 'POL' | 'SPM' | 'PCN' | 'PRI' | 'PSE' | 'PRT' | 'PLW' | 'PRY' | 'QAT' | 'REU' | 'ROU' | 'ROM' | 'SRB' | 'RUS' | 'RWA' | 'SAU' | 'SLB' | 'SYC' | 'SDN' | 'SWE' | 'SGP' | 'SHN' | 'SVN' | 'SJM' | 'SVK' | 'SLE' | 'SMR' | 'SEN' | 'SOM' | 'SUR' | 'SSD' | 'STP' | 'SUN' | 'SLV' | 'SXM' | 'SYR' | 'SWZ' | 'TAA' | 'TCA' | 'TCD' | 'ATF' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TLS' | 'TKM' | 'TUN' | 'TON' | 'TUR' | 'TTO' | 'TUV' | 'TWN' | 'TZA' | 'UKR' | 'UGA' | 'UMI' | 'USA' | 'URY' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'XXK' | 'QZZ' | 'YEM' | 'MYT' | 'YUCS' | 'ZAF' | 'ZMB' | 'ZRCD' | 'ZWE' required

countystring

The county code.

citystring required

The city name.

post_codestring required

The post code of the city.

delivery_phone_numberstring

The delivery phone including the country code.

default_shippingboolean

It is true if it's the default shipping address.

user_idstring

The ID of the User owner of the Address, required only when resource_type is USER.

Example request

{
  "recipient": "JohnSmith",
  "name": "Actual address of John",
  "line1": "Foo street 33",
  "line2": "Second floor",
  "county": "00000",
  "city": "London",
  "post_code": "00000",
  "delivery_phone_number": "+44123323232",
  "default_shipping": true,
  "user_id": "XMPL1234-000003",
  "cards_to_link": [
    [
      "7bf79328-a7ae-4222-aa54-091ff7f429a7",
      "2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
    ]
  ]
}

Response

The returned resource is the single Address created.

idstring

The Address ID.

recipientstring

The recipient of the Address

namestring

The actual name of the Address.

line1string

The Address street.

line2string

An optional other street.

countrystring

The country of the Address.

countystring

The county of the Address.

citystring

The city of the Address.

post_codestring

The postal code of the Address.

delivery_phone_numberstring

Delivery phone number

default_shippingboolean

True if the Address is the default shipping address.

typestring

The type of the Address.

category'USER' | 'COMPANY'

user_idstring

The User ID, only if category of the Address is USER.

creation_timestring

The date and time when the Address was created.

last_updatestring

The date and time when the Address was last updated.

Example response

{
  "id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
  "recipient": "JohnSmith",
  "name": "Foo Street 75",
  "line1": "Bar Street 64",
  "line2": "Other street 31",
  "country": "GB",
  "county": "LD",
  "city": "London",
  "post_code": "00000",
  "delivery_phone_number": "+441234567890",
  "type": "SHIPPING",
  "creation_time": "2017-06-01T12:48:40Z",
  "last_update": "2017-06-01T12:48:40Z"
}

Changes

Aug 6, 20267be21448a2b3 Revision changes
- info
  added the new QZZ enum value to the request property
Feb 11, 2026e4706ef36e2a Revision changes
- breaking
  added the new required request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  the request property became optional
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history