> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Presence Subscription

> Allows the client to send a presence subscription from its account to an XMPP recipient.

## Overview

Allows the client to send a presence subscription from its account to an XMPP recipient. If the account to which the client is logged in has an approved Legal ID associated with it, this ID will be included in the request, to allow the recipient to know who has made the request.

## Authentication

Requires a valid JWT bearer token.

## Notes

This endpoint uses the request schema notation described in [Pattern matching](/guides/pattern-matching).


## OpenAPI

````yaml /test-api/openapi.yaml post /Agent/Xmpp/SendPresenceSubscription
openapi: 3.1.0
info:
  title: Neuron Agent API
  version: 1.0.0
  description: |-
    The Agent API exposes core Neuron functionality over HTTP so services can
    operate without a persistent XMPP connection. Endpoints are grouped by
    capability, starting with Accounts and XMPP messaging.
servers:
  - url: https://{host}
    variables:
      host:
        default: neuron.example.com
        description: Neuron domain issued to you.
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Crypto
  - name: Open intelligence
  - name: Legal and contracts
  - name: State machines
  - name: Storage
  - name: Tokens
  - name: Wallet
  - name: XMPP messaging
paths:
  /Agent/Xmpp/SendPresenceSubscription:
    post:
      tags:
        - XMPP messaging
      summary: Send Presence Subscription
      description: >-
        Allows the client to send a presence subscription from its account to an
        XMPP recipient.
      operationId: post_Agent_Xmpp_SendPresenceSubscription
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                to:
                  type: string
                customXml:
                  type: string
                language:
                  type: string
                id:
                  type: string
              additionalProperties: true
              required:
                - to
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  sent:
                    type: boolean
                  id:
                    type: string
                  RosterItem:
                    type: object
                    properties:
                      bareJid:
                        type: string
                      pendingSubscription:
                        type: boolean
                      status:
                        type: string
                      name:
                        type: string
                      Groups:
                        type: array
                        items:
                          type: string
                    additionalProperties: true
                    required:
                      - bareJid
                      - pendingSubscription
                      - status
                      - name
                additionalProperties: true
                required:
                  - sent
                  - id
                  - RosterItem
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````