---
title: "Send Partnership Invitation"
method: POST
path: "/api/invitations/partnerships"
tags: ["Invitations"]
---

# Send Partnership Invitation

`POST /api/invitations/partnerships`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/invitations/partnerships`
- Auth: HTTP bearer

Send partnership invitation to another organization

Requires: admin role
Creates invitation with 7-day expiry
Sends invitation email in background
Bidirectional: works for both corporate inviting agencies and vice versa

## Request body

- PartnershipInvitationCreateRequest: Send partnership invitation request
  - `invited_org_name` string, required
  - `contact_email` string, email, required
  - `contact_person` string, nullable
  - `contact_phone` string, nullable
  - `message` string, nullable
  - `metadata` object, nullable

## Response `201`

Successful Response

- PartnershipInvitationResponse: Partnership invitation response
  - `id` string, required
  - `inviter_org_id` string, required
  - `inviter_org_name` string, required
  - `inviter_org_type` string, required
  - `invited_org_name` string, required
  - `contact_email` string, required
  - `contact_person` string, nullable, required
  - `contact_phone` string, nullable, required
  - `invitation_token` string, required
  - `message` string, nullable, required
  - `status` string, required
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `accepted_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)