Skip to content

Meridiem Apps

Meridiem supports apps that act on a user's behalf via the OAuth API.

If you want the fastest path, start with the OAuth quickstart. If you want a concrete model for what an app can be, read Build an app like Remark.ing.

To create an app, ensure that you are signed into Meridiem. Go to Settings -> Developer -> Under Apps, click Create. Enter your app's information (it can be changed later) and click Save.

Your app's app_id and app_secret will be generated, and there will be additional fields to add more supplemental data:

  • Optional icon url that will display on the OAuth page
  • Optional scope justification that will also be displayed on the OAuth page, for explaining the purpose of requesting the scopes that your app requests.
  • Optional doc_changed_webhook url for receiving signed document change webhooks.

For webhook payloads, signature headers, and verification details, see Webhooks.

Good first apps

Meridiem apps usually do one or more of these things:

  • Read markwhen documents and turn them into a focused UI.
  • Append new entries from a form, button, automation, SMS, email, or agent.
  • Store app-level settings in the document header.
  • Store structured per-entry details as event properties.
  • React to document changes through webhooks.

For cross-document feeds, search, dashboards, and jobs, see Aggregate queries. For more examples, see What can you build?.