API Reference

Reputoo REST API v1

The RGP API lets you manage contacts, send WhatsApp messages, create campaigns, and enroll contacts in sequences programmatically. All endpoints are under /api/v1/ and require API key authentication.

Base URL

/api/v1

Format

JSON

Auth

Bearer token

Rate limit

60 req/min

Authentication

All requests must include an Authorization header with a Bearer token. Generate API keys from Dashboard → Settings → API Keys.

curl -X GET https://yourapp.com/api/v1/contacts \
  -H "Authorization: Bearer rgp_yourApiKeyHere"

Key Prefix

All API keys start with rgp_

Scopes

read— List and fetch resources

write— Create, update, delete resources

campaigns-only— Create and view campaigns only

read-only— Alias for read scope

Rate Limits

Rate limit: 60 requests/minute per API key.
Exceeded: HTTP 429 { "error": "Rate limit exceeded" }

Contacts

Contact Tags

Sequence Enrollment

Messages

Campaigns

Error Codes

400Bad RequestMissing or invalid request parameters

401UnauthorizedMissing or invalid API key

403ForbiddenAPI key lacks required scope

404Not FoundResource does not exist or belongs to another business

409ConflictResource already exists (e.g., duplicate phone)

429Too Many RequestsRate limit exceeded — retry after 1 minute

500Internal Server ErrorServer-side error — contact support

Before you build

The API works on top of an approved WhatsApp Business API number. If you are setting one up, or connecting Reputoo to the tools you already use without writing code, these guides cover the rest.