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.
Tutorial3 min read
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
pre_sk_Reviews for travel bookings, orders and appointments in Orbit's own satellites need no code: see Ask for reviews after trips and orders.
Addresses
Everything lives under one address:
https://app.bifrostorbit.com/presence/presence/api/public/{business}/reviews/presence/api/v1/organisations/{organisationId}/requests/presence/embed.js/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}.
1Read your reviews
The public reviews API needs no key, so you can try it in a terminal:
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:
{ "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.
2Put them on a page
The quickest way is the widget. Build it under Widgets in the sidebar, or paste this and change the names:
<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 for every attribute and for styling.
3Choose 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.
4Send 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.
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.
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.
- Presence Orbit's events reach your own systems through webhooks in Orbit. See Events.
Was this page helpful?