Create Owner

POST

owners

curl -X POST "https://api.clustr-ai.com/api/public/owners" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "sam@northstar.vc", "first_name": "Sam", "last_name": "Okafor"}'

{
  "success": true,
  "data": {
    "owner": {
      "clustr_owner_id": "own_adj1sxt77abs0d221hcyj2ec45",
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "avatar_url": "",
      "is_member": false,
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "An owner already holds that email", "code": "CONFLICT" }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

Add a person to your owner directory so opportunities can be assigned to them. An owner is a label for assigning work: creating one sends no email, grants no access to your workspace, and uses no seat. That is what lets you assign an intro to an investor, an advisor, or a friend. Any workspace member can create owners. The email is unique within your workspace. Creating an owner with an email that already exists returns a 409.

curl -X POST "https://api.clustr-ai.com/api/public/owners" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "sam@northstar.vc", "first_name": "Sam", "last_name": "Okafor"}'

{
  "success": true,
  "data": {
    "owner": {
      "clustr_owner_id": "own_adj1sxt77abs0d221hcyj2ec45",
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "avatar_url": "",
      "is_member": false,
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "An owner already holds that email", "code": "CONFLICT" }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Body

application/json

string

required

The owner's email address. It must be a valid address with a dotted domain: dana@localhost is rejected as a typo.

Example:

"alice@yourco.com"

first_name

string

Owner first name.

Example:

"Alice"

last_name

string

Owner last name.

Example:

"Martin"

Response

Owner created

success

boolean

data

object

Show child attributes

curl -X POST "https://api.clustr-ai.com/api/public/owners" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "sam@northstar.vc", "first_name": "Sam", "last_name": "Okafor"}'

{
  "success": true,
  "data": {
    "owner": {
      "clustr_owner_id": "own_adj1sxt77abs0d221hcyj2ec45",
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "avatar_url": "",
      "is_member": false,
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "An owner already holds that email", "code": "CONFLICT" }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

Authorizations

Body

Response