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

# Register Agent

> Register a new agent into the Pulsarpay infrastructure.



## OpenAPI

````yaml POST /api/v1/agents/register
openapi: 3.1.0
info:
  title: Pulsarpay API
  description: >-
    Pulsarpay is an automated payment infrastructure designed specifically for
    APIs and autonomous agents. It allows users to top up credits while agents
    execute charges for their services.
  version: 1.0.0
servers:
  - url: https://pulsarpay.io
    description: Production Server
security: []
paths:
  /api/v1/agents/register:
    post:
      tags:
        - Agents
      summary: Register an Agent
      description: Register a new agent into the Pulsarpay infrastructure.
      operationId: registerAgent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRegistration'
      responses:
        '200':
          description: Agent registered successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRegistrationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegisterBadRequestError'
              examples:
                invalidWebsite:
                  summary: Invalid Website
                  value:
                    error: Invalid website URL
                invalidEmailFormat:
                  summary: Invalid Email
                  value:
                    error: Invalid email format
                missingFields:
                  summary: Missing Required Fields
                  value:
                    error: Name, email, and website are required
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegisterConflictError'
              examples:
                nameAlreadyExists:
                  value:
                    error: Agent name already exists. Please choose a different one.
components:
  schemas:
    AgentRegistration:
      type: object
      required:
        - name
        - email
        - website
      properties:
        name:
          type: string
          example: openclaw-agent
          description: >-
            A unique, human-readable name for your agent. This will be displayed
            in user authorization logs and transaction history.
        email:
          type: string
          example: dev@openclaw.ai
          format: email
          description: >-
            Primary developer or organization email. This address will be used
            for manual account activation and critical security notifications.
        website:
          type: string
          example: https://openclaw.ai
          format: uri
          description: >-
            Official landing page or documentation URL for the agent's service.
            Used to verify the legitimacy of the project during onboarding.
    AgentRegistrationResponse:
      type: object
      properties:
        message:
          type: string
          example: >-
            Your agent has been created. To start processing payments, please
            reach out to hello@pulsarpay.io for account activation.
          description: Onboarding instructions and next steps for the developer.
        apiKey:
          type: string
          example: ag_live__xxxxxxxxxxxxxxxxxx
          description: >-
            The secret API key for the agent. This key is used in the
            'X-agent-key' header to authenticate charges. It is only shown once
            upon registration.
        enabled:
          type: boolean
          example: false
          description: >-
            Indicates if the agent is active and authorized to process payments.
            New agents are disabled by default until manual verification is
            completed.
    RegisterBadRequestError:
      type: object
      properties:
        error:
          type: string
          description: Detailed error message describing the validation failure.
    RegisterConflictError:
      type: object
      properties:
        error:
          type: string
          description: >-
            Error message returned when a resource conflict occurs, typically
            due to a duplicate unique field such as the agent name.
          example: Agent name already exists. Please choose a different one.

````