Skip to content

Create a new partner

POST
/api/partners
curl --request POST \
--url https://example.com/api/partners \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "Community Food Pantry", "slaHours": 72, "isDefault": true, "defaultConfidential": false, "description": "Community food pantry providing fresh produce, dry goods, and emergency family assistance.", "keywords": [ "food", "pantry", "groceries", "emergency" ], "website": "https://dreamcenterconnect.com", "publicCategoryName": "Food & Nutrition" }'
Media typeapplication/json
object
name
required

Full display name of the resource, facility, or individual.

string
Example
Community Food Pantry
slaHours
required

Target response timeframe in hours for request routing and resolution.

integer
Example
72
isDefault

Flag designating the default fallback triage partner for unrouted requests.

boolean
Example
true
defaultConfidential

Flag forcing all Needs created for this partner to be marked confidential by default.

boolean
Example
false
description

Detailed operational description or resource notes.

string
Example
Community food pantry providing fresh produce, dry goods, and emergency family assistance.
keywords

Focus keywords describing specialized services.

Array<string>
Example
[
"food",
"pantry",
"groceries",
"emergency"
]
website

Official website URL.

string
Example
https://dreamcenterconnect.com
publicCategoryName

Publicly visible assistance category name.

string
Example
Food & Nutrition

Partner created

Media typeapplication/json
object
id
required

Unique identifier (UUID v4) for the resource.

string format: uuid
organizationId
required

Unique identifier (UUID v4) for the parent organization.

string format: uuid
name
required

Full display name of the resource, facility, or individual.

string
slaHours
required

Target response timeframe in hours for request routing and resolution.

integer
isArchived
required

Flag indicating whether the partner facility is archived.

boolean
isDefault
required

Flag designating the default fallback triage partner for unrouted requests.

boolean
defaultConfidential

Flag forcing all Needs created for this partner to be marked confidential by default.

boolean
description

Detailed operational description or resource notes.

string
keywords

Focus keywords describing specialized services.

Array<string>
website

Official website URL.

string
publicCategoryName

Publicly visible assistance category name.

string
demographicConfig

Map of demographic fields to requirement status (REQUIRED, OPTIONAL, HIDDEN).

object
key
additional properties
string
requireDemographicsForResolution

Flag indicating whether demographic survey completion is required before resolving a need.

boolean
recertificationIntervalDays

Threshold in days before a constituent demographic profile requires recertification (default 365).

integer
voiceStorageEnabled

Partner override for voice recording archival storage. Null inherits organization setting.

boolean
nullable
voiceStorageRetentionDays

Partner override for voice recording retention in days. Null inherits organization setting.

integer
nullable
createdAt
required

UTC ISO-8601 timestamp when the record was created.

string format: date-time
Example
{
"id": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
"organizationId": "10000000-0000-0000-0000-000000000001",
"name": "Community Food Pantry",
"slaHours": 72,
"isArchived": false,
"isDefault": true,
"defaultConfidential": false,
"description": "Community food pantry providing fresh produce, dry goods, and emergency family assistance.",
"keywords": [
"food",
"pantry",
"groceries",
"emergency"
],
"website": "https://dreamcenterconnect.com",
"publicCategoryName": "Food & Nutrition",
"requireDemographicsForResolution": true,
"recertificationIntervalDays": 365,
"voiceStorageEnabled": false,
"voiceStorageRetentionDays": 90,
"createdAt": "2026-07-28T12:00:00Z"
}

Unauthorized