Agent provisioning.

BulkRender supports fully autonomous agent registration. An AI agent can call one endpoint, receive an API key, and begin generating documents immediately, without any human involvement at signup time.

Because the agent acts autonomously, BulkRender caps monthly spend at $5.00 until a human operator confirms the registration via a 6-digit one-time code sent to their email. This protects against abuse and ensures a real person is accountable for each agent account.

The agent is never blocked. It receives credentials and can work immediately under the $5 cap. Verification simply lifts that cap.

Call POST /api/agent/provision with an email identity for the agent, a Stripe payment method ID, and the human operator's email address.

curl -X POST https://api.bulkrender.com/api/agent/provision \
  -H "Content-Type: application/json" \
  -d '{
    "email": "invoice-bot@yourcompany.com",
    "paymentMethodId": "pm_...",
    "humanEmail": "operator@yourcompany.com"
  }'

Request body

Successful response

{
  "success": true,
  "data": {
    "apiKey": "br_live_...",
    "orgId": "org_...",
    "credits": 0
  },
  "humanVerificationRequired": true,
  "verificationNotice": "A 6-digit verification code has been sent to the human operator email provided. Usage is capped at $5.00/month until the human operator enters the code at https://app.bulkrender.com/verify-agent (link included in the email)."
}

Authenticate all subsequent API calls with:

X-API-Key: br_live_...

After registration, BulkRender emails a 6-digit code to the humanEmail address. The code expires in 24 hours.

The email links to app.bulkrender.com/verify-agent, where the operator enters the code to lift the spend cap. This step must be completed by a human. Programmatic interception or automated submission of the code violates BulkRender's terms of service.

The same verification is also available over the API, for reference:

curl -X POST https://api.bulkrender.com/api/agent/verify-email-otp \
  -H "Content-Type: application/json" \
  -d '{
    "organizationId": "org_...",
    "otpCode": "847291"
  }'

Response

The OTP is deleted after first successful use. A new code cannot be requested via API. Contact support if the code expires before the operator completes verification.

Agent accounts are credit-based. Add credits at any time by calling POST /api/agent/topup with the API key and a USD amount. Minimum top-up is $1.00.

curl -X POST https://api.bulkrender.com/api/agent/topup \
  -H "X-API-Key: br_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "amount": 10 }'

The charge is applied to the payment method on file. Credits are added instantly on successful charge.

DOCX generation costs 1 credit ($0.10). PDF generation costs 2 credits ($0.20). 1 credit = $0.10 USD.

Limits are enforced automatically on every charge. The human operator can view current limits and period spend, and request changes, from the BulkRender dashboard after signing in.