# Get started as a developer

> What you can build with Presence Orbit, which credential each part needs, and your first request, from reviews on your own website to review requests sent by your shop system.

Source: https://docs.bifrostorbit.com/presence/developers/get-started/

Presence Orbit keeps your organisation's locations, their reviews from Google, Facebook, Trustpilot and other sites, and the review requests you send. As a developer you can show those reviews on your own website, send review requests from your own systems, and let AI assistants work with Presence Orbit.

## What to use for what

| You want to | Use | Credential | Plan |
| --- | --- | --- | --- |
| Show reviews on any website, with no code to maintain | The [review widget](https://docs.bifrostorbit.com/presence/developers/widgets/) | None | Every plan |
| Show reviews with your own markup | The [public reviews API](https://docs.bifrostorbit.com/presence/developers/reviews-api/) | None | Every plan |
| Show reviews on a website built with CMS Orbit | CMS Orbit's own review blocks. See [Your reviews on websites built with CMS Orbit](https://docs.bifrostorbit.com/presence/everyone/reviews-in-cms-orbit/) | None | Every plan |
| Ask customers for a review from your till, booking or shop system | The [review requests API](https://docs.bifrostorbit.com/presence/developers/review-requests-api/) | Secret key, `pre_sk_` | Growth and above |
| Let Claude, ChatGPT or another assistant work with Presence Orbit | The [MCP server](https://docs.bifrostorbit.com/presence/developers/mcp/) | OAuth sign-in as a person | Every plan |
| React when a review arrives | [Events](https://docs.bifrostorbit.com/presence/developers/events/) through Orbit Exchange, for Orbit's own satellites | None for you to manage | Every plan |

Reviews for travel bookings, orders and appointments in Orbit's own satellites need no code: see [Ask for reviews after trips and orders](https://docs.bifrostorbit.com/presence/everyone/requests-after-trips-and-orders/).

## Addresses

Everything lives under one address:

```text
https://app.bifrostorbit.com/presence
```

| Part | Address |
| --- | --- |
| Public reviews API | `/presence/api/public/{business}/reviews` |
| Review requests API | `/presence/api/v1/organisations/{organisationId}/requests` |
| Widget script | `/presence/embed.js` |
| MCP server | `/presence/mcp` |

`{business}` is your organisation's **Short name** under **Settings**, such as `northwilds`. `{organisationId}` is the id in the address bar when you open Presence Orbit: `/presence/o/{organisationId}`.

## 1. Read your reviews

The public reviews API needs no key, so you can try it in a terminal:

```bash
curl "https://app.bifrostorbit.com/presence/api/public/northwilds/reviews?location=northwilds-oslo&limit=3"
```

It answers with the average, the number of reviews, the newest reviews and a sentence that says where they come from:

```json
{
  "data": {
    "business": "Northwilds Oslo",
    "average": 4.6,
    "total": 131,
    "reviews": [{ "author": "Ingrid B.", "rating": 5, "text": "Great advice on boots for the Lofoten trip.", "sourceName": "Google" }],
    "disclosure": "Reviews from Google, Facebook, Trustpilot and Imported, the newest first, none left out. 3 of 131 shown. Published as written by customers; we reply but never edit them.",
    "howUrl": "https://app.bifrostorbit.com/presence/l/northwilds/northwilds-oslo"
  }
}
```

Each review has more fields than shown here. See [Public reviews API](https://docs.bifrostorbit.com/presence/developers/reviews-api/).

## 2. Put them on a page

The quickest way is the widget. Build it under **Widgets** in the sidebar, or paste this and change the names:

```html
<div data-presence-reviews data-business="northwilds" data-location="northwilds-oslo" data-layout="list"></div>
<script src="https://app.bifrostorbit.com/presence/embed.js" async></script>
```

See [Embed review widgets](https://docs.bifrostorbit.com/presence/developers/widgets/) for every attribute and for styling.

## 3. Choose who may load them

By default any website can load your reviews. To allow only your own, an Admin lists them under **Settings**, **Your website**: your main website and up to 19 more, such as `https://staging.northwilds.com`. Browsers on other websites then get `403`.

## 4. Send a review request

For requests from your own systems, an Admin creates a key under **API keys**. Every key is a secret key, starting `pre_sk_`, which stays on your server: Presence Orbit refuses it from a browser.

```bash
curl -X POST "https://app.bifrostorbit.com/presence/api/v1/organisations/{organisationId}/requests" \
  -H "Authorization: Bearer pre_sk_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ingrid Berg", "email": "ingrid@example.com", "location": "northwilds-oslo" }'
```

Presence Orbit waits the delay and quiet hours set under **Review requests**, then sends it. See [Review requests API](https://docs.bifrostorbit.com/presence/developers/review-requests-api/).

## What isn't there yet

- The **API playground** has nothing to try yet. It fills in as Presence Orbit gets endpoints for locations and reviews.
- There is no SDK, no GraphQL and no API for locations, replies or listings.
- The MCP server has one tool so far. See [The MCP server](https://docs.bifrostorbit.com/presence/developers/mcp/).
- Presence Orbit's events reach your own systems through [webhooks in Orbit](https://docs.bifrostorbit.com/orbit/developers/orbit-webhooks/). See [Events](https://docs.bifrostorbit.com/presence/developers/events/).
