# Resend a pending or expired partner invitation

`POST https://api.suger.cloud/org/{orgId}/prm/invitation/{invitationId}/resend`

Re-send an invitation this organization sent, refreshing its accept-by date and re-delivering the original email. An expired invitation returns to pending with a new accept-by date; an invitation that is still pending simply gets a longer window.

Use it to chase a partner who never responded, or to revive an invitation that timed out, without composing a new one. The partner receives the same message that was originally approved, from the same sender identity.

Only invitations that are still pending or have expired can be resent. One that was already accepted, declined or cancelled returns 409 with the current status in info.currentStatus — for an accepted one the partnership is already active, and for a declined one send a fresh invitation with CreatePrmInvitation instead. Reviving an expired invitation also returns 409 when another invitation to the same recipient is already pending, so one recipient never ends up with two live accept links.

Delivery is reported separately from the record: emailSent is false when the accept-by window was refreshed but no email left the system, for example a disconnected sender integration. Callers should not report a plain success in that case.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `invitationId` | path | string | yes | Invitation ID |

## Responses

### 200 — OK

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

**`ResendInvitationResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `emailError` | string | no | EmailError is the delivery failure, present only when EmailSent is false. |
| `emailSent` | boolean | no | EmailSent is false when no email left the system — a disconnected sender integration, or a legacy row with no stored outbound message to re-send. |
| `invitation` | PartnerInvitation | no |  |

**`PartnerInvitation`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createTime` | string | no | Creation timestamp |
| `createdBy` | string | no | ISV user ID who sent the invitation (outbound), null for inbound |
| `direction` | string | no | OUTBOUND (ISV invites partner) or INBOUND (partner applies via public URL) |
| `engagementId` | string | no | Shared identifier that pairs an outbound invitation with its inbound counterpart (Case A paired send, Cases B/C accept-synthesized). Null for non-paired rows. |
| `expiresAt` | string | no | When the invitation expires. Defaults at the DB to 15 days after insert (CURRENT_TIMESTAMP + 15 days); past this it can no longer be accepted/declined and the daily cron marks it Expired. |
| `id` | string | no | ID of the ent. Unique invitation identifier (UUID) |
| `info` | PartnerInvitationInfo | no |  |
| `lastUpdateTime` | string | no | Last update timestamp |
| `organizationId` | string | no | The ISV organization that owns this invitation |
| `partnerOrganizationId` | string | no | The partner's Suger org ID, set on acceptance after org provisioning |
| `partnershipId` | string | no | Target partnership. Nullable for inbound invitations before a partner record exists. |
| `purpose` | string | no | Invitation purpose: network, account_overlap, deal_collaboration |
| `respondedAt` | string | no | When the recipient responded (accepted or declined) |
| `sentAt` | string | no | When the invitation was sent (outbound) or submitted (inbound) |
| `status` | string | no | Invitation status: Sent, Accepted, Declined, Expired |
| `trackingToken` | string | no | UUID token for accept/decline links (outbound) or form URL (inbound) |

**`PartnerInvitationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `inbound` | InboundInvitationInfo | no |  |
| `outbound` | OutboundInvitationInfo | no |  |

**`InboundInvitationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `formData` | object | no | FormData holds the submitted form field values. |
| `formId` | string | no | FormID is the ID of the form configuration used for this submission. |
| `senderOrgId` | string | no | SenderOrgID is the resolved Suger org of the applicant who submitted this inbound application (the sender / partner side). Optional: set at submit time only when the work-email domain matches exactly ONE production, PRM-enabled-or-PARTNER Suger org; empty when zero or multiple matched. Read at accept time to link the ISV-side partnership to this org and create the reciprocal partnership record on the sender side. |
| `submitterEmail` | string | no | SubmitterEmail is the email of the partner who submitted the form. |
| `submitterName` | string | no | SubmitterName is the name of the partner who submitted the form. |

**`OutboundInvitationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `acceptInitiatedAt` | string | no | AcceptInitiatedAt (RFC3339) is stamped when the recipient submits the public accept form (records intent + ResponseMessage) BEFORE signing in via Auth0. The authenticated finalize step requires it before verifying the Auth0 email against RecipientEmail and provisioning ( two-step accept flow). |
| `aiContext` | string | no | AIContext is additional context provided for AI email generation. |
| `ccEmails` | array<string> | no | CcEmails is the list of CC email addresses. |
| `contextMessage` | string | no | ContextMessage is the user-provided engagement context. |
| `crmObjectId` | string | no | CrmObjectID is the CRM account record id (Salesforce Account Id) this invite was created from in the "From your CRM" flow (/). Threaded to acceptance so the created ISV-side partnership is linked to its CRM account (info.crmAccountInfo.accountId) — which the CRM document sync relies on. Empty for non-CRM invites. Salesforce-only today. |
| `emailProvider` | string | no | EmailProvider is the sender integration the original send resolved to: "GOOGLE", "MICROSOFT" or "DNS" (the org's verified custom domain). Empty on legacy rows and when the sender did not pin one. Persisted so a RESEND re-uses the same identity — without it a resend silently falls back to the user-scope Gmail/Outlook path, which changes the From address (and DMARC alignment) for an org that deliberately sent over DNS or org-scope Gmail. |
| `emailScope` | string | no | EmailScope is "user" (the sender's own mailbox, the default) or "org" (the org-level Gmail service account). Persisted for the same reason as EmailProvider — see above. |
| `intendedChannels` | array<string> | no | IntendedChannels is the marketplace channel classification computed at send time from the recipient email's domain: ["Direct"] for Case B, the matched marketplace(s) for Case C, and the matched org's inferred channels (or ["Direct"]) for Case A. Used at acceptance to populate the ISV-side partnership's info.channels when an ISV-side partnership must be created from the invitation. |
| `messageBody` | string | no | MessageBody is the final email body (HTML). |
| `messageSubject` | string | no | MessageSubject is the final email subject line. |
| `partnerCompanyName` | string | no | PartnerCompanyName is the free-text partner company name entered by the sender in "Invite a new partner" mode. Unset when the invitation is for a pre-existing partnership (Select Recommended Partner mode). |
| `recipientEmail` | string | no | RecipientEmail is the partner contact email the invitation was sent to. |
| `recipientName` | string | no | RecipientName is the partner contact name. |
| `responseMessage` | string | no | ResponseMessage is the partner's response when accepting or declining the invitation. Mandatory for Accepted invitations, optional for Declined. |
| `tone` | string | no | Tone is the selected email tone: executive, sales, technical, alliance, tactical. |

### 400 — Invitation not found, or not an outbound invitation

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

**`ServErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `info` | object | no |  |
| `message` | string | no |  |

### 409 — Invitation is not resendable

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

**`ServErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `info` | object | no |  |
| `message` | string | no |  |

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.suger.io/get-started/oauth-app/)._

### Request

```bash
curl -X POST 'https://api.suger.cloud/org/{orgId}/prm/invitation/{invitationId}/resend' \
  -H 'Authorization: Bearer $SUGER_TOKEN'
```

### Response — 200

```json
{
  "emailError": "buyer@example.com",
  "emailSent": true,
  "invitation": {
    "createTime": "2026-01-31T12:00:00Z",
    "createdBy": "string",
    "direction": "string",
    "engagementId": "01H0000000000000000000",
    "expiresAt": "string",
    "id": "01H0000000000000000000",
    "info": {
      "inbound": {
        "formData": {},
        "formId": "01H0000000000000000000",
        "senderOrgId": "01H0000000000000000000",
        "submitterEmail": "buyer@example.com",
        "submitterName": "Acme Corp"
      },
      "outbound": {
        "acceptInitiatedAt": "string",
        "aiContext": "string",
        "ccEmails": [
          "buyer@example.com"
        ],
        "contextMessage": "string",
        "crmObjectId": "01H0000000000000000000",
        "emailProvider": "buyer@example.com",
        "emailScope": "buyer@example.com",
        "intendedChannels": [
          "string"
        ],
        "messageBody": "string",
        "messageSubject": "string",
        "partnerCompanyName": "Acme Corp",
        "recipientEmail": "buyer@example.com"
      }
    },
    "lastUpdateTime": "2026-01-31T12:00:00Z",
    "organizationId": "01H0000000000000000000",
    "partnerOrganizationId": "01H0000000000000000000",
    "partnershipId": "01H0000000000000000000",
    "purpose": "string"
  }
}
```

### Error — 400

```json
{
  "message": "string"
}
```

---

Interactive API reference: https://doc.suger.io/api/