buymeamalt.Register an application ↗

API REFERENCE

One connection. Your community.

Use hosted connections for new integrations. Choose an endpoint to see its authentication, parameters, examples and errors.

Authentication & connections

Your API key authenticates the approved application. Creator consent controls access to each account. Keep all credentials and requests on your server.

Request headers
X-BMM-Client-ID: your-application-id
X-BMM-API-Key: your-server-only-api-key
X-BMM-User-ID: your-authenticated-user-id

Profile, earnings and disconnect use X-BMM-User-ID. Start and complete take partner_user_id in their JSON body instead. Derive both from your authenticated server session.

Start a connection

Create a secure connection attempt for your signed-in user.

POST
Complete a connection

Validate the callback and activate the creator's connection.

POST
Creator profile

Read an authorised profile and its attributed support link.

GET
Attributed support links

Display a support button while retaining application attribution.

Earnings

Read settled earnings from your integration, with permission.

GET
Revocation

Disconnect a creator and stop authorised data access.

DELETE
Errors and responses

Handle denied access, expired attempts and temporary failures.

Existing OAuth integrations

The OAuth protocol remains supported. These endpoints require the existing token flow; do not mix OAuth tokens with hosted connection requests.

OAuth authenticationOAuth authorisationOAuth tokensOAuth profileOAuth earningsOAuth revocation

Prefer a file for your tools? The complete Markdown reference remains available, including operator setup and application lifecycle details.