Introduction
Connect your own systems to ArchFindr with scoped API keys and signed webhooks.
The ArchFindr integration API lets a vendor read and manage its catalogue and buyer requests from its own systems, such as an ERP, a PIM or a CRM. It is a JSON API over HTTPS, secured with API keys that you create and scope yourself.
Getting started
Register an integration, get it approved, create a key and make your first request.
Authentication
Send your key as a bearer token and choose the scopes it needs.
Webhooks
Receive signed events when requests arrive or products go live.
API reference
Every endpoint with parameters, responses and examples.
Base URL
All endpoints live under /api/v1/key on the ArchFindr API origin:
https://api.archfindr.com/api/v1/keyUse the API origin shown in your vendor workspace if your account runs on a different host.
Conventions
- Requests and responses are JSON (
Content-Type: application/json). - Field names are camelCase and timestamps are ISO 8601 strings in UTC.
- Identifiers are UUIDs, passed and returned as strings.
- Prices are numbers in the product currency (SAR for the Saudi market).
- A key sees only what its owner can see: a vendor key reads and writes that vendor's data.
Where to go next
Start with Getting started. When something fails, read Errors. To keep your system in sync without polling, use Webhooks.