> ## Documentation Index > Fetch the complete documentation index at: https://docs.younegotiate.com/llms.txt > Use this file to discover all available pages before exploring further. # Send consumer manual SMS > Send a manual SMS from the Superadmin consumer detail page and create an automated communication history row with `superadmin_profile` as the source. The API uses the active communication-profile mobile when present; otherwise it uses the account mobile. If that recipient has unsubscribed, Superadmin may send to another available non-unsubscribed phone on the same consumer profile. ## OpenAPI ````yaml /api/superadmin.openapi.yaml post /manage-consumers/{consumer}/sms openapi: 3.1.0 info: title: YouNegotiate Superadmin API version: '2.0' description: Stateless API endpoints for the Superadmin portal. servers: - url: https://api.hub.younegotiate.com description: Production security: [] tags: - name: System description: Public superadmin domain system and health endpoints. - name: Authentication description: Superadmin login, logout, password reset, and password change endpoints. - name: Profile description: Authenticated superadmin profile endpoints. - name: Admin Configuration description: Platform configuration values and feature flag controls. - name: MailHub Users description: Superadmin management for EcoMail Hub / EcoPortal users. - name: Super Admin Users description: Superadmin management for platform operations users. - name: Consumers description: Superadmin consumer account list, detail, filter, and export endpoints. - name: Creditors description: Superadmin creditor account list and account access endpoints. - name: Sub Accounts description: Superadmin sub account list and export endpoints. - name: Reseller Partners description: Superadmin reseller partner list and report-history endpoints. - name: Special Plan Inquiries description: >- Superadmin special membership inquiry list, detail, resolve, and close endpoints. - name: Plans description: >- Superadmin membership plan list, create, update, reorder, visibility, and delete endpoints. - name: Failed - Canceled description: Superadmin failed or cancelled membership list and custom email endpoints. - name: Merchant Requests description: >- Superadmin merchant API request list, export, email, forwarding, progress, and approval endpoints. - name: Bill Pay Donations description: Superadmin Bill Pay gift donation list, export, and receipt endpoints. - name: Export & Reporting description: Superadmin generated report options and CSV download endpoints. - name: Communications / Templates description: >- Superadmin email and SMS template management for manual communications and campaigns. - name: Communications / Groups description: >- Superadmin communication group management for dynamic consumer targeting and campaign selection. - name: Communications / Schedule Campaign description: >- Superadmin email and SMS campaign scheduling, immediate send, and delivery queue endpoints. - name: Communications / Campaign Tracker description: >- Superadmin campaign tracker snapshots, refresh actions, and consumer exports. - name: Automated Communications description: >- Superadmin automated email/SMS templates, trigger configuration, and delivery history endpoints. paths: /manage-consumers/{consumer}/sms: post: tags: - Consumers summary: Send consumer manual SMS description: >- Send a manual SMS from the Superadmin consumer detail page and create an automated communication history row with `superadmin_profile` as the source. The API uses the active communication-profile mobile when present; otherwise it uses the account mobile. If that recipient has unsubscribed, Superadmin may send to another available non-unsubscribed phone on the same consumer profile. operationId: superadminSendConsumerSms parameters: - name: consumer in: path required: true description: Consumer ID. schema: type: integer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SendManageConsumerSmsRequest' responses: '200': description: SMS sent through Twilio and communication history recorded. content: application/json: schema: $ref: '#/components/schemas/SendManageConsumerSmsResponse' '401': $ref: '#/components/responses/Unauthenticated' '404': $ref: '#/components/responses/NotFound' '409': description: >- Account state, recipient, permission, or unsubscribe state prevents sending SMS. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' '422': $ref: '#/components/responses/ValidationError' '429': description: Manual SMS cooldown is active for this Superadmin and consumer. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' '502': description: >- Twilio is not configured, the phone number is invalid, or Twilio rejected the message. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' security: - bearerAuth: [] components: schemas: SendManageConsumerSmsRequest: type: object additionalProperties: false required: - content properties: content: type: string description: >- SMS body sent to Twilio. The API records successful segment count and cost from Twilio when reported, otherwise it estimates GSM-7 or Unicode segments. example: Hello, please review your account. SendManageConsumerSmsResponse: type: object required: - message - data properties: message: type: string example: Message sent. data: type: object additionalProperties: false required: - communication_history_id - recipient_phone - sms_segment_count - cost properties: communication_history_id: type: integer example: 102 recipient_phone: type: string description: Normalized E.164 phone number sent to Twilio. example: '+19005090050' sms_segment_count: type: integer example: 2 cost: type: number format: float example: 0.0246 MessageResponse: type: object required: - message properties: message: type: string ValidationErrorResponse: type: object required: - message - errors properties: message: type: string errors: type: object additionalProperties: type: array items: type: string responses: Unauthenticated: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' ValidationError: description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Sanctum token ````