Invite a partner | JazzHQ AI

curl -X POST https://api.jazzhq.ai/api/v1/vendors/partners \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "companyName": "Acme Inc",
  "contactName": "Jane Doe",
  "contactEmailAddress": "jane.doe@acme.com"
}'

{
  "success": true,
  "message": "PARTNER_INVITE_SUCCESSFUL",
  "data": {
    "id": 1001,
    "companyName": "Acme Inc",
    "description": "Leading provider of industrial solutions and equipment.",
    "website": "https://www.acmeinc.com",
    "country": "USA",
    "companySize": "200-500 employees",
    "contactName": "Jane Doe",
    "contactEmailAddress": "jane.doe@acme.com",
    "contactPhone": "+1-555-123-4567",
    "contactRole": "Business Development Manager",
    "type": "RESELLER",
    "invitedAt": "2024-01-15T09:30:00Z",
    "createdAt": "2024-01-15T09:30:00Z"
  },
  "timestamp": "2024-01-15T09:30:00Z"
}

Creates a new partner and sends them an invite email.

If a user matching contactEmailAddress already exists, that existing partner is connected to your vendor account instead of creating a duplicate partner record.

Authentication

X-API-KEYstring

Your vendor API key. Required on every request under /api/v1/vendors/**.

Request

This endpoint expects an object.

companyNamestringRequired

contactNamestringRequired

contactEmailAddressstringRequiredformat: "email"

contactPhonestring or nullOptional

typeenum or nullOptional

Response

Partner invited successfully.

successbooleanOptional

messagestringOptional

dataobjectOptional

timestampdatetimeOptional

Errors

400

Bad Request Error

403

Forbidden Error

500

Internal Server Error