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": {
      "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, not an account: 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, there is no admin gate. The email is unique within your tenant. Creating an owner with an email that already exists returns a 409.

Body

string

required

Owner email address.

string

Owner first name.

string

Owner last name.

Response Fields

object

The created owner.

string

Owner UUID. Pass this as owner_id when updating an opportunity.

string

Email address.

string

First name, empty when it was not provided.

string

Last name, empty when it was not provided.

string

Profile picture URL. Empty for a newly created owner.

boolean

true when the email belongs to a member of your workspace, false otherwise.

integer

How many opportunities this owner holds. Zero for a new owner.

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": {
      "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" }
}

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": {
      "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

Target Accounts

ICP

Competitor Monitoring

Body

Response Fields

​Body

​Response Fields

Body

Response Fields