Use Hoko with a custom API client

Call Hoko's unversioned REST resources from your application.

Before you start

Create a scoped key in Dashboard > Integrations > API Keys. Keep it in your server secret store. Use https://api.hoko.to.

Make your first request

Send the bearer key and read collections with GET https://api.hoko.to/collections. Use a returned collection ID with POST /links. Find a link with GET /links?externalId=... and send a unique request ID.

Verify the connection

Start with a read. Confirm the workspace and scopes. Save an external ID before a write. If a response is uncertain, read that external ID once and stop if the result is empty or ambiguous.

Fix common issues

  • Use 401 for an invalid key.
  • Use 403 for a missing scope.
  • Use 429 for a rate limit.
  • Honor Retry-After. Never retry an uncertain create blindly.

Disconnect

Remove the key from your secret store and revoke it in Hoko.

See the custom API reference at https://docs.hoko.to/custom-api.

Open Apps · Technical reference · All app guides