---
title: "Create an organization"
method: POST
path: "/v2/teams/{teamKey}/organizations"
tags: ["Organizations"]
---

# Create an organization

`POST /v2/teams/{teamKey}/organizations`

## Request

- Base URL: `https://api.streak.com/api`
- URL: `https://api.streak.com/api/v2/teams/{teamKey}/organizations`
- Auth: HTTP bearer

Creates an organization in a team. Available enrichment data may fill missing details. Provide a name or at least one domain. Set custom fields and relationships in a subsequent update.

## Path parameters

- `teamKey` string, required

## Query parameters

- `getIfExisting` boolean

## Request body

- OrganizationCreateBody: Details for a new organization. Provide a name or at least one domain.
  - `name` string, nullable: Organization name.
  - `other` string, nullable: Freeform notes about the organization.
  - `domains` string[], nullable: Website domains for the organization, with the primary domain first.
  - `industry` string, nullable: Industry of the organization.
  - `phoneNumbers` string[], nullable: Phone numbers for the organization.
  - `addresses` string[], nullable: Postal addresses for the organization.
  - `employeeCount` string, nullable: Company size as text, which can include an employee-count range.
  - `logoURL` string, nullable: URL of the organization's logo.
  - `twitterHandle` string, nullable: Twitter profile handle or URL.
  - `facebookHandle` string, nullable: Facebook profile handle or URL.
  - `linkedinHandle` string, nullable: LinkedIn profile handle or URL.
  - `instagramHandle` string, nullable: Instagram profile handle or URL.

## Response `200`

OK

- Organization: An organization shared with the team.
  - `key` string, required: Stable key for this organization.
  - `teamKey` string, required: Key for the team that owns this organization.
  - `name` string, nullable: Name of the organization.
  - `other` string, nullable: Notes about the organization.
  - `domains` string[], required: Website domains in their stored order.
  - `normalizedDomains` string[], required: Stored normalized website domains.
  - `industry` string, nullable: Industry of the organization.
  - `phoneNumbers` string[], required: Phone numbers in their stored order.
  - `addresses` string[], required: Postal addresses in their stored order.
  - `employeeCount` string, nullable: Employee count or range as text.
  - `logoURL` string, nullable: URL of the organization logo.
  - `twitterHandle` string, nullable: Twitter profile handle.
  - `facebookHandle` string, nullable: Facebook profile handle.
  - `linkedinHandle` string, nullable: LinkedIn profile handle.
  - `instagramHandle` string, nullable: Instagram profile handle.
  - `lastSavedUserKey` string, nullable: Key for the user who last edited this record.
  - `creatorKey` string, nullable: Key for the user who created this record.
  - `creationDate` integer, nullable: Time this record was first created, in epoch milliseconds.
  - `versionTimestamp` integer, nullable: Time this version of the record was created, in epoch milliseconds.
  - `lastSavedTimestamp` integer, nullable: Time this record was last saved, in epoch milliseconds.
  - `lastEnrichmentTimestamp` integer, nullable: Time enrichment was last applied or reviewed, in epoch milliseconds.
  - `contactLinks` ContactLink[], required: Contacts linked to this record, in their stored order.
    - `key` string, required: Key for the linked contact.
    - `isMagicLinked` boolean: Whether Streak linked this record automatically.
    - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds.
  - `orgLinks` OrganizationLink[], required: Organizations linked to this record, in their stored order.
    - `key` string, required: Stable key for the linked organization.
    - `isMagicLinked` boolean: Whether Streak linked this record automatically.
    - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds.
  - `fields` object, required: Custom field values keyed by field identifier.

## Changes

- **2026-10-16** `1c3a5ef8b9ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak/changes/v2/teams/:teamKey/organizations/post.md)

---

[API](https://skmtc.dev/streakyc/apis/streak.md) - [All operations](https://skmtc.dev/streakyc/apis/streak/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak/revisions/3648671fd1cf?raw)