Skip to content
AchaduDevelopers
Operational APIGo to website
Dashboard
Achadu/Developers/Concepts

A predictable model for the entire operation.

Before calling endpoints, understand how account, resources, states, and events relate to each other. The same model applies to REST, MCP and CLI.

Resources and identity

Each key belongs to a single account. IDs are opaque, stable and only make sense within that account; never derive meaning from the prefix or size.

Account

The root of offers, audience, store, integrations and revenue.

Offer

The product found or created before any publication.

Publication

A traceable attempt to distribute an offer to a destination.

Contact and conversation

The person and service history in DU Inbox.

Journey

The versionable flow that reacts to events and performs actions.

Receiving

Reconcilable evidence of commission and payment.

States and transitions

Asynchronous operations return the current state, not a promise of immediate completion. Follow the timeline or subscribe to the corresponding event.

1
Created

The appeal has been accepted and given an ID.

2
In processing

The dedicated queue performs the task outside of the HTTP request.

3
Completed or failed

The result, trials and error are available for audit.

Missing dates, values and fields

IDsOpaque strings like off_..., pub_... and conv_...
DatesISO 8601 in UTC, for example 2026-08-31T18:20:00.000Z
MoneyDecimal number accompanied by currency in ISO 4217
Optional fieldsThey can be omitted; null represents known absence
BooleansUse true or false, never 0, 1 or text

Consistency and side effects

Immediate readings

CRUD and configuration reflect recording committed to the same account.

Asynchronous processing

Publishing, importing, syncing, and execution can continue after the response.

Events after commit

The webhook is enqueued only after the change has been persisted.

Explicit deletion

Destructive endpoints are marked in the reference and are never inferred by an update.