API docs / Get started

Quickstart

Create a key, list your members and log your first contribution.

1. Create an API key

You’ll need to be an admin of your organization.

  1. In Equity Matrix, open the account menu and choose API Keys.
  2. Select Create API Key and give it a name of up to 50 characters, like Harvest. The name appears in front of every contribution sent with the key.
  3. Copy the key. It starts with em_live_ and is only shown once, so store it somewhere safe, like a password manager.

The examples in these docs read the key from an environment variable, so it never ends up in your shell history or in code you share:

export EQUITY_MATRIX_API_KEY="paste-your-key-here"

2. List your members

Every contribution belongs to a member. This call returns each member’s id and email, which you’ll use to say whose contribution it is.

curl https://api.equitymatrix.io/v1/members \
  -H "Authorization: Bearer $EQUITY_MATRIX_API_KEY"
{
  "data": [
    {
      "id": 57,
      "firstName": "Ana",
      "lastName": "Lopez",
      "email": "ana@example.com",
      "role": "ADMIN",
      "title": "Co-founder",
      "hourlyRate": 85,
      "status": "ACTIVE"
    }
  ]
}

3. Log a contribution

This logs 3.5 hours for Ana. The externalId is the record’s ID in the system it came from. If you send the same externalId again, Equity Matrix updates that contribution instead of adding a new one.

curl https://api.equitymatrix.io/v1/contributions \
  -H "Authorization: Bearer $EQUITY_MATRIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "memberEmail": "ana@example.com",
    "type": "TIME",
    "value": 3.5,
    "date": "2026-09-30",
    "description": "Q3 close",
    "externalId": "harvest:time_entry:2291837"
  }'

The response is the saved contribution, with the slices it earned:

{
  "result": "created",
  "contribution": {
    "id": 1842,
    "externalId": "harvest:time_entry:2291837",
    "memberId": 57,
    "memberName": "Ana Lopez",
    "type": "TIME",
    "contributionTypeId": null,
    "contributionTypeName": null,
    "expenseSource": null,
    "value": 3.5,
    "date": "2026-09-30",
    "description": "Q3 close",
    "hourlyRate": 85,
    "multiplier": 2,
    "slices": 595,
    "source": "API",
    "apiKeyName": "Harvest",
    "createdAt": "2026-09-30T18:04:11Z",
    "updatedAt": "2026-09-30T18:04:11Z"
  }
}

Next steps

  • Read Syncing with external IDs before connecting a tool that edits or deletes records.
  • Pick your tool under Setup in the menu.