# Dispatch survey invitation SMS
URL: /docs/api-reference/micro-surveys-nps/sendSurveyInvitation

## POST `/api/v1/public/surveys/send`

**Summary:** Dispatch survey invitation SMS
**Operation ID:** `sendSurveyInvitation`

Generates a unique short token, deducts SMS segments + service surcharge, and sends SMS invitation with responsive web link.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Request Body (`application/json`)

```json
{
  "type": "object",
  "required": [
    "recipient"
  ],
  "properties": {
    "surveyId": {
      "type": "string",
      "format": "uuid"
    },
    "title": {
      "type": "string",
      "example": "Feedback Request"
    },
    "recipient": {
      "type": "string",
      "example": "+233241234567"
    },
    "senderId": {
      "type": "string",
      "example": "FEEDBACK"
    },
    "customMessage": {
      "type": "string",
      "example": "Hi! Please take 30 seconds to rate us: {link}"
    }
  }
}
```

### Responses

- **`200`**: Survey invitation dispatched

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "message": {
      "type": "string",
      "example": "Survey invitation dispatched"
    }
  }
}
```
- **`401`**: Authentication failed or API key missing