v1

latestOpenAPI 3.0.02026-08-062438369.6 KB

Organizations

Create a new Organization

Creates a new Organization and attaches it to the requesting partner's family. This endpoint is restricted to an authorized partner integration — all other callers receive a 403.

post/organizations

Request body

namestring required

The name of the organization

descriptionstring required

A description of the organization

org_sizeinteger required

The number of people in the organization

emailstring email required

The primary contact email for the organization

type'NPO' | 'BIZ' | 'FCO' | 'GOV' | 'EDU' required

The organization type. Possible values: NPO — Non-profit organization; BIZ — Business; FCO — Faith-based organization; GOV — Governmental; EDU — Educational institution.

mission_statementstring nullable

The mission statement for the organization

websitestring nullable

The website URL for the organization

phonestring nullable

The primary phone number for the organization

Example request

{
  "name": "Help the Hungry",
  "description": "A nonprofit dedicated to eliminating food insecurity in our community.",
  "org_size": 250,
  "email": "admin@helpthehungry.org",
  "type": "NPO",
  "address": {
    "lat": 33.214561,
    "lng": -96.614456,
    "country": "United States",
    "locality": "McKinney",
    "timezone": "America/Chicago",
    "postal_code": "75069",
    "country_short": "US",
    "locality_short": "McKinney",
    "formatted_address": "610 Elm St Suite 800, McKinney, TX 75069, USA",
    "postal_code_short": "75069",
    "administrative_area_level_1": "Texas",
    "administrative_area_level_1_short": "TX"
  },
  "mission_statement": "To end hunger one meal at a time.",
  "website": "https://helpthehungry.org",
  "phone": "5551234567"
}

Response

Returns the newly created organization record, including its generated slug and all default field values. The organization is automatically linked as a child of your partner organization. Note: on success this endpoint returns 200 OK, not 201 Created.