Organizations

The organization endpoints let you create, list, retrieve, and update organizations, manage team members, configure overage limits, and control auto phone enrichment (B2B).

Endpoints

Create Organization

Creates a new organization.

Method: POST
Path: /organization

Request Body

Response Body

Returns the created organization object with id, name, and other fields.

Example

curl -X POST "https://api.app.bullseye.so/api/v1/organization" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json" 
  -d '{"organizationName": "Acme Corp", "domain": "acme.com"}'

List Organizations

Returns all organizations the authenticated user is a member of.

Method: GET
Path: /organization/list

Response Body

Returns an array of organization objects.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/organization/list" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json"

Get Organization

Returns details for a single organization.

Method: GET
Path: /organization/\{organization_id\}

Path Parameters

Response Body

Returns the organization object with full details.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/organization/org_abc123" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json"

Update Organization

Updates an existing organization.

Method: PUT
Path: /organization/\{organization_id\}

Path Parameters

Request Body

JSON object with the fields to update (e.g., name, domain).

Response Body

Returns the updated organization object.

Example

curl -X PUT "https://api.app.bullseye.so/api/v1/organization/org_abc123" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json" 
  -d '{"name": "Acme Corp Updated"}'

Remove Team Member

Removes a user from the organization.

Method: DELETE
Path: /organization/\{organization_id\}/member/\{user_id\}

Path Parameters

Response Body

Returns the updated organization or membership list.

Example

curl -X DELETE "https://api.app.bullseye.so/api/v1/organization/org_abc123/member/user_xyz789" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json"

Set Max Overages

Updates the maximum overage limit for the organization.

Method: PATCH
Path: /organization/\{organization_id\}/max-overages

Path Parameters

Request Body

JSON object with the overage limit value (structure depends on API implementation).

Response Body

Returns the updated overage configuration.

Example

curl -X PATCH "https://api.app.bullseye.so/api/v1/organization/org_abc123/max-overages" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json" 
  -d '{"maxOverages": 100}'

Update Auto Phone Enrichment

Enable or disable automatic phone enrichment after visitor identification. B2B (plus_employee) only. When enabled, Bullseye starts a phone number search for newly identified visitors who have a LinkedIn URL. Skips when identification credits are below 5. Never auto-retries after not_found.

Method: PATCH
Path: /organization/\{organization_id\}/auto-phone-enrichment

Path Parameters

Request Body

Response Body

Returns the updated organization object (includes autoPhoneEnrichmentEnabled).

Error codes

Example

curl -X PATCH "https://api.app.bullseye.so/api/v1/organization/org_abc123/auto-phone-enrichment" 
  -H "X-API-Key: bsk_live_your_api_key_here" 
  -H "Content-Type: application/json" 
  -d '{"enabled": true}'