Sign in
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.

Example response

{
  "data": {
    "id": 12345,
    "name": "VOMO Org",
    "slug": "vomo",
    "type": "NPO",
    "description": "A nonprofit dedicated to eliminating food insecurity.",
    "email": "admin@vomo.org",
    "phone": "123-456-7890",
    "website": "https://vomo.org",
    "tax_number": "12-3456789",
    "org_size": 500,
    "background_check_expiration": "1_YEAR",
    "background_check_expiration_mode": "relative",
    "background_check_absolute_expiration": "2025-12-31",
    "invitation_token": "VOMO",
    "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"
    },
    "groups_moniker": "Group",
    "created_at": "2019-02-01 17:33:39",
    "updated_at": "2019-05-31 19:31:43",
    "show_categories": 1,
    "project_moniker": "Project",
    "campaign_moniker": "Campaign",
    "logo": {
      "id": 99908,
      "type": "LOGO",
      "mediable_id": 12345,
      "mediable_type": "organization",
      "created_at": "2019-03-28 15:37:09",
      "updated_at": "2019-03-28 15:37:14"
    }
  }
}

Changes