---
title: "Log-in (authenticate) a partner user."
method: POST
path: "/api/partners/auth"
tags: ["Authentication", "Partners"]
---

# Log-in (authenticate) a partner user.

`POST /api/partners/auth`

## Request

- Base URL: `https://api.mobilecoach.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobilecoach.org/api/partners/auth`
- Auth: none declared

Returns an authentication token to be used for all other API calls.

All fields are required (`username`, `password`, and `appKey`).

Note: `email` is deprecated and `username` should be used instead.

Contact <a href="mailto:support@newstartmobile.com">support@newstartmobile.com</a>
if you do not know your `appKey`.

## Request body

- PartnerLoginRequest
  - `appKey` string, required
  - `username` string
  - `email` string
  - `password` string, required

## Response `200`

OK

- PartnerLoginResponse
  - `success` boolean
  - `error` string
  - `token` string
  - `expires` string, date-time

## Changes

- **2026-10-09** `f08e033be1fd`: 3 info
  - api operation id `loginPartner` removed and replaced with `loginPartnerUser`
  - added the new optional request property `username`
  - the request property `email` became optional

[Operation history](https://skmtc.dev/mobilecoach/apis/mobilecoach-api/changes/api/partners/auth/post.md)

---

[API](https://skmtc.dev/mobilecoach/apis/mobilecoach-api.md) - [All operations](https://skmtc.dev/mobilecoach/apis/mobilecoach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mobilecoach/apis/mobilecoach-api/revisions/df463b248fcb?raw)