Skip to main content
GET

List all sales channels

Scope:sales:sales-channels.read
https://api.holded.com/api/v2/sales-channels

Returns the list of all sales channels in your account. The response includes both active and archived sales channels. Use sales channel IDs when setting defaults on contacts or assigning revenue to document lines.

Request

python
import requests

url = "https://api.holded.com/api/v2/sales-channels"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Office Expenses",
      "color": "#FF5733",
      "account_num": 6290001,
      "archived": false,
      "description": "string"
    }
  ]
}

Success responses

200List of sales channelsapplication/json
object
items[]object[]
idstring

Unique identifier of the accounting account

namestring

Display name of the accounting account

colorstring

Hex color code used in the UI

account_numinteger

Numeric accounting code from the chart of accounts

archivedboolean

Whether the account is archived

descriptionstring | null

Description of the accounting account

Error responses

401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json