Quickstart - Hermios Developers

1. Create an API key

Settings → MCP & APIs → API keys → Create. Pick a role that can read and write companies and people, keep the 90-day expiry, and copy the key.

export HERMIOS_API_KEY="<your key>"

2. List companies

curl "https://api.hermios.app/rest/companies?limit=5&order_by=createdAt[DescNullsLast]" \
  -H "Authorization: Bearer $HERMIOS_API_KEY"

{
  "data": { "companies": [{ "id": "…", "name": "Acme", "domainName": { "primaryLinkUrl": "https://acme.com" } }] },
  "totalCount": 42,
  "pageInfo": { "hasNextPage": true, "endCursor": "…" }
}

3. Create a person at that company

curl -X POST "https://api.hermios.app/rest/people" \
  -H "Authorization: Bearer $HERMIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": { "firstName": "Ada", "lastName": "Lovelace" },
    "emails": { "primaryEmail": "ada@acme.com" },
    "companyId": "<company id from step 2>"
  }'

4. The same with GraphQL

curl "https://api.hermios.app/graphql" \
  -H "Authorization: Bearer $HERMIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ companies(first: 5) { totalCount edges { node { id name } } } }"}'

Next

REST: filters, sorting, pagination, batch writes.
Webhooks: get notified instead of polling.
MCP: connect an assistant.