Directories API

Update a custom claims administrator

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

PATCHhttps://app.mindbill.org/partner/v2/organization/claims-administrators/{id}

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.

Path parameters

FieldTypeDescription

idRequired

string

Identifier returned by this organization's list endpoint.

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/custom_example' \
  --request PATCH \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"name":"Example Claims Office","fax":"+15555550123"}'

Response

200 OK

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