Start here

Getting started

The Bynli App is how you read, listen to, and contribute to data across the Bynli platform — community resources, webhooks, and an embed widget, all behind one bearer token.

What you can do

• Sign in with Bynli — add Bynli as an OAuth 2.0 / OIDC provider to your site or app so users authenticate with their existing Bynli account.
• Read community resources published by organizations on Bynli.
• Submit new resources for moderator review.
• Manage your organization's directory (team staff only).
• Subscribe to webhooks when things change.
• Embed your directory on any website with one script tag.

Get a key

Sign in at bynli.com/dash/login and open /dash/developers. Click Create key, give it a label (like my-side-project), and copy the token that appears. You'll only see it once.

Your first call

Try a public read — no team required:

curl https://bynli.com/dash/api/v1/resources \
  -H "Authorization: Bearer bapi_pk_your_key_here"

You should get back JSON that looks something like this:

{
  "success": true,
  "count": 12,
  "resources": [
    {
      "id": 101,
      "name": "Atlanta Community Food Bank",
      "category": "food",
      "address": "732 Joseph E. Lowery Blvd NW, Atlanta, GA",
      "website": "https://www.acfb.org"
    }
  ]
}

Next steps

• Read Authentication to understand how your key is checked.
• Setting up "Sign in with Bynli" for your own app? See OAuth 2.0 / OpenID Connect.
• Browse Resources — read for the full field list and filters.
• Want to contribute data? See Resources — submit.