# Edit a contact at a partner

`PATCH https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/contact/{contactId}`

Edit a person on a partner's Relationship Hub contact list; fields you leave out stay as they are. `partnershipId` is the partnership id from ListPrmPartnerships, and `contactId` the contact's `id` from ListPrmOrgPartnerContacts with `partnershipIds`, or, when it has none, its plain email (not URL-encoded). Changing the email of a contact already in the CRM is refused with 400, and nothing is saved. Setting `role` pins it, so later title changes no longer re-infer it. With `syncToCrm` the contact's name and title, never its phone or LinkedIn, are pushed to the partnership's linked Salesforce Account, only the non-empty values that changed; with no linked Salesforce Account nothing is pushed.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `partnershipId` | path | string | yes | Partnership ID |
| `contactId` | path | string | yes | Contact id, or the email of a contact without one |

## Request Body

Required.

Content-Type: `application/json` · Schema: `UpdatePrmPartnerContactInput`

**`UpdatePrmPartnerContactInput`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | string | no |  |
| `firstName` | string | no |  |
| `lastName` | string | no |  |
| `linkedinUrl` | string | no |  |
| `phone` | string | no |  |
| `role` | PrmContactRole | no |  |
| `syncToCrm` | boolean | no | SyncToCrm pushes the edit to the Salesforce Contact afterwards. |
| `title` | string | no |  |

## Responses

### 200 — OK

Content-Type: `application/json` · Schema: `PrmPartnerHubContactWriteResult`

**`PrmPartnerHubContactWriteResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `contact` | PartnerContact | no |  |
| `sync` | SyncPrmPartnerContactsResult | no |  |

**`PartnerContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `apolloId` | string | no | ApolloID is the Apollo.io person ID for re-enrichment. |
| `crmContactId` | string | no | CrmContactID is the person's record under the linked CRM Account. |
| `email` | string | no | Email is the contact's verified email address. |
| `enrichedAt` | string | no | EnrichedAt is the RFC3339 timestamp of the last enrichment. |
| `firstName` | string | no |  |
| `id` | string | no | ID is the partnership_contact row id. Empty until someone acted on the person (added, edited, synced, removed); address such a person by email. |
| `invitationId` | string | no | InvitationID and InvitedAt describe the pending invitation when Portal is INVITED. |
| `invitedAt` | string | no |  |
| `isPrimary` | boolean | no | IsPrimary indicates this is the highest-seniority partnership contact. |
| `lastActivityAt` | string | no | LastActivityAt is the person's last sign-in to the partner portal. |
| `lastName` | string | no |  |
| `linkedinUrl` | string | no | LinkedinURL is the contact's LinkedIn profile URL. |
| `name` | string | no | Name is the contact's full name. |
| `ownDomain` | boolean | no | OwnDomain marks a person on the ISV's own email domain. Such rows are returned only with includeOwnDomain and are never synced, invited or made champion. |
| `phone` | string | no |  |
| `portal` | PrmContactPortalStatus | no |  |
| `role` | PrmContactRole | no |  |
| `seniority` | string | no | Seniority is the contact's seniority level (e.g., "vp", "director", "manager", "ic"). |
| `source` | PrmContactSource | no |  |
| `syncError` | string | no | SyncError is the CRM's error from the last failed sync, verbatim. |
| `syncStatus` | PrmContactSyncStatus | no |  |
| `title` | string | no | Title is the contact's job title/role (e.g., "VP of Partnerships"). |

**`SyncPrmPartnerContactsResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `queued` | array<string> | no |  |
| `skipped` | array<PrmPartnerHubContactRowResult> | no |  |

**`PrmPartnerHubContactRowResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | string | no |  |
| `message` | string | no |  |
| `status` | string | no | Status is ADDED, EXISTING or INVALID for an import; SKIPPED for a sync. |

### 400 — Bad request error

Content-Type: `application/json`

### 404 — Contact not found

Content-Type: `application/json`

## Example

_The request bodies are this operation's documented examples; the response and error bodies are generated from its schema. Substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X PATCH 'https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/contact/{contactId}' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "VP Alliances",
  "role": "EXECUTIVE"
}'
```

### Response — 200

```json
{
  "contact": {
    "apolloId": "01H0000000000000000000",
    "crmContactId": "01H0000000000000000000",
    "email": "buyer@example.com",
    "enrichedAt": "string",
    "firstName": "Acme Corp",
    "id": "01H0000000000000000000",
    "invitationId": "01H0000000000000000000",
    "invitedAt": "2026-01-31T12:00:00Z",
    "isPrimary": true,
    "lastActivityAt": "2026-01-31T12:00:00Z",
    "lastName": "Acme Corp",
    "linkedinUrl": "https://example.com"
  },
  "sync": {
    "queued": [
      "string"
    ],
    "skipped": [
      {
        "email": "buyer@example.com",
        "message": "string",
        "status": "string"
      }
    ]
  }
}
```

### Error — 400

```json
"string"
```

---

API reference: https://doc.fours.com/api/
