Getting started
Create an API key and make your first request within five minutes.
What is the Appficient API?
With the Appficient API you automate anything you can also do by hand in Appficient: create clients, send invoices, follow up quotes, move deals and more. It is a REST API with JSON, API keys and predictable responses.
Create an API key
Sign in to Appficient and open Settings, then API. Create a new key and grant only the scopes your integration needs. Keys always start with apf_.
You see the full key once, right after creation. Keep it in a secrets manager or environment variable — never in code or version control.
Your first request
All requests go to:
https://api.appficient.nlFirst check that you can reach the API. No key required:
curl -sS https://api.appficient.nl/v1/ping{
"data": {
"pong": true,
"surface": "extern",
"version": "v1"
},
"meta": {}
}Then call with your key. This endpoint shows which key you use and which scopes it has:
curl -sS https://api.appficient.nl/v1/me \
-H "Authorization: Bearer apf_your_key_here"{
"data": {
"surface": "extern",
"actor": {
"type": "api_key",
"label": "Integratie"
},
"scopes": [
"invoices.read",
"invoices.write"
]
},
"meta": {}
}If you see this response, your integration works. Congratulations!
Next steps
- Authentication: how to send the key and what never to do.
- Conventions: how requests and responses are shaped (envelope, pagination, filters).
- Invoices: the most common starting point. List invoices with one GET.