Skip to main content
POST

Authorizations

Authorization
string
header
required

User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.

Headers

x-signature
string
required

Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.

x-timestamp
string
required

Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.

Body

application/json
name
string
required

Name for the developer API key

payoutAddress
string

Legacy external payout wallet. Optional; agent fee claims credit the Echo Zero in-app wallet.

developerProfile
object

Developer profile information

recruiterReferralCode
string

Referral code of the developer who recruited you (developer referral program). Only for accounts that signed up without a referral; an account referred at signup is linked to that referrer automatically. Ignored while the program is paused. 400 if the code is unknown, is your own, belongs to a non-developer or to a developer who has not joined the program, or the account was already referred by someone else.

Maximum string length: 64
Example:

"V1StGXR8_Z5jdHi6B-myT"

Response

Developer registered. Raw key and secret returned.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload