Directories API

Create a custom claims administrator

Save an organization-specific fax, email, or mail destination.

POSThttps://app.mindbill.org/partner/v2/organization/claims-administrators

Manage a destination outside the shared electronic payer directory.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: orgs:write · Browser: organization:manage

IdempotencyNot required

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Request body

FieldTypeDescription

nameRequired

string

Claims administrator display name.

1–200 characters

fax

string | null

Fax destination; required unless an email or mailing address is supplied.

At most 50 characters

email

string | null

Email destination.

Valid email, at most 254 characters; empty or null clears it

mailingAddress

string | null

Mailing address as text, not a structured address object.

At most 2,000 characters

notes

string | null

Internal contact notes.

At most 4,000 characters

Examples

curl 'https://app.mindbill.org/partner/v2/organization/claims-administrators' \
  --request POST \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"name":"Example Claims Office","fax":"+15555550123"}'

Response

201 Created

{
  "data": {
    "id": "custom_example",
    "name": "Example Claims Office",
    "fax": "+15555550123",
    "email": null,
    "mailingAddress": null,
    "submissionMethod": "fax",
    "notes": null,
    "active": true,
    "createdAt": "2026-09-01T12:00:00.000Z"
  }
}

FieldTypeDescription

dataRequired

CustomClaimsAdministrator

Saved contact and server-derived submissionMethod.