Getting Started
The seventhings customer API lets you manage fixed assets, rooms, locations, users, files, tasks, and rental cases for a seventhings instance programmatically. Start with what you want to do — you only need one of the paths below.
Choose your path
Section titled “Choose your path”| I want to… | Choose | Who it’s for |
|---|---|---|
| Connect an AI assistant to seventhings | MCP server | People using Claude, ChatGPT, or another compatible AI application to work with their instance |
| Connect business tools and automate workflows | Automation platforms | Teams using n8n or Zapier who don’t want to build a custom application; Zapier is currently in private preview |
| Build an integration into my own application | SDK quickstart | Developers building custom applications, data exports, or synchronization services |
| Browse resources or automate tasks from a terminal | CLI | Technical users working interactively, with shell scripts, or in CI |
Building an integration? Use the language your team already maintains. The SDK quickstart includes runnable Go, PHP, Python, and TypeScript starters. If you’re starting from scratch, Choose your SDK helps you decide based on your task and environment.
Using AI? Choose MCP to let an AI assistant work with your seventhings instance. Choose the SDK quickstart to write and run your own integration, with or without an AI coding tool.
Follow your chosen guide for connection and authentication setup. You don’t need to read every integration guide before getting started.
Need something else?
Section titled “Need something else?”- API clients — explore and test requests manually in Postman, Insomnia, or Bruno.
- API Reference — look up endpoints or build an integration using raw HTTP instead of an SDK.
API basics
Section titled “API basics”The details below are useful when working directly with API requests. If you’re using MCP or an automation platform, start with its setup guide instead.
Base URL
Section titled “Base URL”Every seventhings instance exposes the API at:
https://your-instance.seventhings.com/customer-api/v1Enter your seventhings subdomain in the Instance field at the top of this
site — every code example in the API Reference will update to use
it automatically. If you’re copying examples elsewhere, replace
your-instance with your subdomain by hand.
Making a request
Section titled “Making a request”All requests and responses use JSON. Timestamps are always returned in UTC
using the Y-m-d H:i:s format — convert to a local time zone on the client
side. Translatable text is returned in a neutral form so that translation
happens on the client side too.
Most endpoints require a bearer token — see Authentication for how to obtain one.