# Draft a partnership invitation email

`POST https://api.suger.cloud/org/{orgId}/prm/partner/invitation/generate-email`

Generate a subject line and body for a partnership invitation email, written for a specific recipient using this organization's partnership profile and what is known about the partner company.

Use it to prepare wording before inviting someone, or to rewrite a draft. It returns text only — it sends nothing, creates no invitation, and changes no record. Sending is a separate step with CreatePrmInvitation.

It calls a language model and records AI usage for the organization, so each call has a cost. Generate once and edit the result; repeated regeneration adds cost with no new information.

## Parameters

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

## Request Body

Required.

Content-Type: `application/json` · Schema: `partner.GenerateEmailRequest`

**`partner.GenerateEmailRequest`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `aiContext` | string | no |  |
| `contextMessage` | string | no |  |
| `organizationName` | string | no |  |
| `partnerId` | string | no |  |
| `partnerName` | string | no |  |
| `partnerOverview` | string | no |  |
| `purpose` | string | yes |  |
| `senderName` | string | no |  |
| `tone` | string | yes |  |
| `useTemplatePlaceholder` | boolean | no | UseTemplatePlaceholder generates a reusable template (for bulk invite): the model emits the literal "{{partner}}" token wherever the partner company name would go, instead of a specific name. The caller substitutes the token per recipient. When set, PartnerName/PartnerID are not required. |

## Responses

### 200 — OK

Content-Type: `application/json` · Schema: `partner.GenerateEmailResponse`

**`partner.GenerateEmailResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | string | no |  |
| `subject` | string | no |  |

### 400 — Bad request error

Content-Type: `application/json`

---

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