Organization lists

Create, manage, and access organization lists in your Sumble account via the API.

Organization lists let you group target accounts for tracking, enrichment, or export. You can create lists, add organizations to them, and retrieve their contents programmatically.

See Account lists for how lists are created and managed in the web application.

Credit cost

Operation	Cost
List organization lists	1 credit per list returned
Get organization list details	1 credit per organization returned
Create organization list	No credit cost
Add organizations to a list	No credit cost

List organization lists

Returns your saved organization lists with each list's ID, name, and organization count.

List organization lists

get

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

require_mcpbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v5/organization-lists

HTTPcURLJavaScriptPython

GET /v5/organization-lists HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "0195f8d2-1f67-7f52-b1d1-4d63c1e6e7b8",
  "credits_used": 2,
  "credits_remaining": 998,
  "organization_lists": [
    {
      "id": 42,
      "name": "Enterprise Targets",
      "organizations_count": 150,
      "type": "group"
    },
    {
      "id": 43,
      "name": "SMB Pipeline",
      "organizations_count": 75,
      "type": "user"
    }
  ]
}

---

Get organization list details

Returns one organization list and the organizations currently in it.

Use the list_id returned from the list endpoint.

Get organization list details

get

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

list_idintegerRequired

Query parameters

require_mcpbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v5/organization-lists/{list_id}

HTTPcURLJavaScriptPython

GET /v5/organization-lists/{list_id} HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "0195f8d2-1f67-7f52-b1d1-4d63c1e6e7b8",
  "credits_used": 1,
  "credits_remaining": 997,
  "list_info": {
    "id": 42,
    "name": "Enterprise Targets",
    "organizations_count": 1
  },
  "organizations": [
    {
      "id": 1726684,
      "name": "Sumble",
      "slug": "sumble",
      "url": "sumble.com",
      "employee_count": 12
    }
  ]
}

---

Create organization list

Create a new, empty organization list. Use the returned id to add organizations to it.

Create an organization list

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

require_mcpbooleanOptionalDefault: false

Body

application/json

namestringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/v5/organization-lists

HTTPcURLJavaScriptPython

POST /v5/organization-lists HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "name": "Enterprise Targets"
}

{
  "id": 42,
  "name": "Enterprise Targets"
}

---

Add organizations to a list

Add organizations to an existing list by their Sumble IDs or slugs. Organizations that are already in the list are silently skipped. Invalid IDs or slugs are returned in the failure arrays.

If you have company names or domains but not Sumble IDs or slugs, use the match endpoint first to resolve them.

Add organizations to a list

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

list_idintegerRequired

Query parameters

require_mcpbooleanOptionalDefault: false

Body

application/json

organization_idsinteger[]OptionalDefault: []

organization_slugsstring[]OptionalDefault: []

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/v5/organization-lists/{list_id}/organizations

HTTPcURLJavaScriptPython

POST /v5/organization-lists/{list_id}/organizations HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "organization_ids": [
    1,
    99999999
  ],
  "organization_slugs": [
    "sumble",
    "non-existing-org"
  ]
}

{
  "added": [
    1,
    1726684
  ],
  "failed_ids": [
    99999999
  ],
  "failed_slugs": [
    "non-existing-org"
  ]
}