Skip to main content
POST
https://api.vomo.org/v1
/
organizations
Create a New Organization
curl --request POST \
  --url https://api.vomo.org/v1/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{
  "data": {
    "id": 53,
    "name": "Riverside Hope East Campus",
    "slug": "riverside-hope-east",
    "type": "NPO",
    "description": "East campus community programs.",
    "email": "east@riversidehope.example.org",
    "phone": "(555) 012-0105",
    "website": null,
    "tax_number": null,
    "org_size": 60,
    "background_check_expiration": "1_YEAR",
    "background_check_expiration_mode": "relative",
    "background_check_absolute_expiration": null,
    "invitation_token": "RHFEAST",
    "address": {
      "lat": 33.219,
      "lng": -96.6,
      "country": "United States",
      "locality": "McKinney",
      "timezone": "America/Chicago",
      "postal_code": "75071",
      "country_short": "US",
      "locality_short": "McKinney",
      "formatted_address": "200 Redbud Blvd, McKinney, TX 75071, USA",
      "postal_code_short": "75071",
      "administrative_area_level_1": "Texas",
      "administrative_area_level_1_short": "TX"
    },
    "groups_moniker": "Group",
    "giving_enabled": false,
    "created_at": "2025-11-20 09:00:00",
    "updated_at": "2025-11-20 09:00:00",
    "deleted_at": null,
    "show_categories": 1,
    "show_rewards": 0,
    "project_moniker": "Project",
    "campaign_moniker": "Campaign",
    "user_submitted_projects": 0,
    "logo": null,
    "child_organizations": [],
    "parent_organizations": [
      {
        "id": 50,
        "name": "Riverside Hope Foundation",
        "slug": "riverside-hope",
        "type": "NPO",
        "description": "A nonprofit dedicated to eliminating food insecurity in North Texas.",
        "email": "info@riversidehope.example.org",
        "phone": "(555) 012-0100",
        "website": "https://riversidehope.example.org",
        "tax_number": "75-0000050",
        "org_size": 250,
        "background_check_expiration": "1_YEAR",
        "background_check_expiration_mode": "relative",
        "background_check_absolute_expiration": null,
        "invitation_token": "RHFMAIN",
        "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, McKinney, TX 75069, USA",
          "postal_code_short": "75069",
          "administrative_area_level_1": "Texas",
          "administrative_area_level_1_short": "TX"
        },
        "groups_moniker": "Group",
        "giving_enabled": false,
        "created_at": "2025-11-01 09:00:00",
        "updated_at": "2025-11-10 14:00:00",
        "deleted_at": null,
        "show_categories": 1,
        "show_rewards": 0,
        "project_moniker": "Project",
        "campaign_moniker": "Campaign",
        "user_submitted_projects": 0,
        "logo": null
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Organization to create

Request body for creating an organization.

​
name
string
required

The name of the organization

Example:

"Help the Hungry"

​
description
string
required

A description of the organization

Example:

"A nonprofit dedicated to eliminating food insecurity in our community."

​
org_size
integer
required

The number of people in the organization

Required range: x >= 0
Example:

250

​
email
string<email>
required

The primary contact email for the organization

Example:

"admin@helpthehungry.org"

​
type
enum<string>
required

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

Available options:
NPO,
BIZ,
FCO,
GOV,
EDU
Example:

"NPO"

​
address
object
required

The address of the organization in Google Maps API format. All address fields are required when creating an organization.

​
mission_statement
string | null

The mission statement for the organization

Example:

"To end hunger one meal at a time."

​
website
string | null

The website URL for the organization

Example:

"https://helpthehungry.org"

​
phone
string | null

The primary phone number for the organization

Example:

"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.

​
data
object

A VOMO Organization

Last modified on June 5, 2026