Skip to main content
POST
/
api
/
v1
/
agents
/
register
Register an Agent
curl --request POST \
  --url https://pulsarpay.io/api/v1/agents/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "openclaw-agent",
  "email": "dev@openclaw.ai",
  "website": "https://openclaw.ai"
}
'
{ "message": "Your agent has been created. To start processing payments, please reach out to hello@pulsarpay.io for account activation.", "apiKey": "ag_live__xxxxxxxxxxxxxxxxxx", "enabled": false }

Body

application/json
​
name
string
required

A unique, human-readable name for your agent. This will be displayed in user authorization logs and transaction history.

Example:

"openclaw-agent"

​
email
string<email>
required

Primary developer or organization email. This address will be used for manual account activation and critical security notifications.

Example:

"dev@openclaw.ai"

​
website
string<uri>
required

Official landing page or documentation URL for the agent's service. Used to verify the legitimacy of the project during onboarding.

Example:

"https://openclaw.ai"

Response

Agent registered successfully

​
message
string

Onboarding instructions and next steps for the developer.

Example:

"Your agent has been created. To start processing payments, please reach out to hello@pulsarpay.io for account activation."

​
apiKey
string

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.

Example:

"ag_live__xxxxxxxxxxxxxxxxxx"

​
enabled
boolean

Indicates if the agent is active and authorized to process payments. New agents are disabled by default until manual verification is completed.

Example:

false