List Sectors

GET /external/v1/sectors

Returns all sectors (teams) in your account. Sectors are referenced by opportunities (sector_id) and conversations.

Authentication

Requires sectors:read permission.

Request

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/sectors" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/sectors', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/sectors',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Response

{
  "success": true,
  "data": [
    {
      "id": "sec_01",
      "name": "Inbound",
      "description": null,
      "color": "#6366f1",
      "is_active": true,
      "created_at": "2026-01-10T08:00:00Z",
      "updated_at": "2026-01-10T08:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Sector identifier
name	string	Sector/team name
description	string	Optional description (nullable)
color	string	Hex color for UI
is_active	boolean	Whether the sector is active
created_at	string	ISO 8601 creation timestamp
updated_at	string	ISO 8601 last update timestamp