Creates an association between an existing GlobalContact person and a party.

post

https://integrationhub.wellsky.io/commands/v4/partycontacts

This endpoint matches Desktop's "Search to Add Contact" functionality.
Works for all party types: Provider, Supplier, Facility, Carrier.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

api-version

string

The requested API version

Body Params

The request containing association information.

Request to associate an existing GlobalContact person with a party (Provider, Supplier, Facility, or Carrier).
Matches Desktop "Search to Add Contact" functionality.

partyId

int64

required

≥ 1

The ID of the party (Provider, Supplier, Facility, or Carrier).
This is the Party.Id from Common.Party table.

partyType

string

required

length between 0 and 50

The type of party being associated.
Valid values: Provider, Supplier, Facility, Carrier.
Must match the actual PartyType_Id of the specified Party.

personId

int64

required

≥ 1

The ID of the person (GlobalContact) to associate.
Must be PersonType_Id = 14 (GlobalContact).

contactType

string | null

Optional contact type classification (e.g., Primary, Emergency, Billing).
Lookup value from Lookups.ContactType table.

relationshipType

string | null

Optional relationship type (e.g., Business Partner, Assistant).
Lookup value from Lookups.RelationshipType table.

Headers

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

201Contact associated successfully

400Validation error (invalid PersonType, duplicate association, invalid lookups, etc.)

404Party or Person not found

500Internal Server Error