API and webhooks
Connect GPS to the systems you run. On your terms.
The Empiraa GPS REST API gives your systems access to goals, objectives, actions, meetings, ideas, comments, progress and users. Webhooks tell your systems when something changes, and every API key is scoped to the job it does.
- Set up with your plan
- Unlimited users
- 30-day pilot
https://plan.empiraa.app/api/v1 // base URL
GET/goals // list goals
POST/goals // create a goal
POST/objectives // add an objective to a goal
PATCH/objectives/{id} // record this week’s actual
Why it matters
No integration list covers every system you run.
What gets in the way
Numbers in your own systems
Operational KPIs live in a warehouse, a BI tool or a line-of-business system.
Updates typed twice
Someone reads a figure in one system and types it into the plan.
Reports built by hand
Strategy data never reaches the dashboards the business already uses.
How it works
A plain REST API, built around the plan.
The API
Read and write the plan
Create goals, add objectives under them, record progress and manage actions. Read meetings, ideas, comments and users. Lists come back in pages, with totals.
- JSON over HTTPS
- Objectives are where KPIs live
- Paged lists with totals
goals // top-level targets
objectives // KPIs and key results
actions // the work that moves them
progress // check-ins and actuals
meetings, ideas, comments, users
Keys scoped to the job
Create an API key for each connection and give it only the scopes it needs, read or write, resource by resource. The organisation comes from the key, so a key reaches only its own workspace.
Weekly actuals sync // one key per connection
READgoals, objectives
WRITEobjectives, progress
NONEmeetings, ideas, comments, users // not needed
Webhooks for changes
Webhooks notify your systems when something changes in GPS, so they can react straight away instead of checking on a schedule.
GPS // something changes in the plan
→ your endpoint // notified straight away
→ your workflow // update, alert or sync
What teams build
Common ways teams use the API.
Use cases
Push weekly actuals
Send KPI values from a data warehouse or BI tool into objectives each week.
Create actions from other systems
Turn work raised elsewhere into GPS actions with an owner.
Feed your dashboards
Pull goals, objectives and progress into the reporting tools you already use.
Trigger workflows
Use webhooks to alert a team or update another system when the plan changes.
Getting access
From request to first call.
The steps
Ask for access
Send an enquiry and we will share the API documentation.
Create a scoped key
Create a key for the connection with only the scopes it needs.
Connect your system
Build it yourself, or have our team help during implementation.
Need a hand with the connection?
Connecting your systems is part of implementation. Tell us what you run and we will scope it with you.
Security
The same protection as the app.
How API access is protected
Scoped keys
Each key can read or write only the resources you choose.
Encrypted
Data is encrypted in transit with TLS and at rest with AES-256.
Separate workspaces
A key reaches only its own organisation’s data.
Read about securityQuestions
API questions, answered.
Does Empiraa GPS have an API?
Yes. A REST API with JSON responses covers goals, objectives, actions, meetings, ideas, comments, progress and users, and webhooks tell your systems when something changes.
How do we get API access?
Send an enquiry and we will share the API documentation. Keys are created for your organisation, each with its own scopes.
Can we update KPIs from our own systems?
Yes. KPIs are objectives in the API, so your system can send a new value to an objective, for example every week from a data warehouse.
Is the API included in our plan?
Yes. The API and webhooks are part of every plan. Any work to connect your systems is part of how we scope your rollout. See how pricing works.
Can a key reach another organisation’s data?
No. The organisation comes from the key itself, so a key reaches only its own workspace.
Question not answered here? Ask ANI and get a straight answer.
Connect GPS to the systems you run.
Book a 15-minute demo, or ask for API access and we will send the documentation.