---
title: "Authenticate Using User Credentials"
method: POST
path: "/auth/user"
tags: ["Authentication"]
---

# Authenticate Using User Credentials

`POST /auth/user`

## Request

- Base URL: `https://ws.zipformplus.com/api`
- URL: `https://ws.zipformplus.com/api/auth/user`
- Auth: none required

Authenticates the partner application and a zipForm® user using username/password or user GUID, and returns a Context Id for use in subsequent requests.

Optionally supply `LinkExternalId` to link the user's account to a partner external ID.

**Returns 409** if account linking fails.

## Request body

- object
  - `SharedKey` string, required: Partner shared key
  - `UserName` string: zipForm® username (use with Password)
  - `Password` string: zipForm® password
  - `UserId` string: zipForm® user GUID (alternative to UserName/Password)
  - `LinkExternalId` string: Optional. Partner external ID to link to this zipForm® account.

## Response `200`

Authentication successful

- ContextIdResponse
  - `contextId` string: Session identifier to be used in subsequent requests

## Other responses

- `401`: Unauthorized — invalid credentials
- `409`: Account linking failed

---

[API](https://skmtc.dev/lwolf/apis/zipform-partner-api.md) · [All operations](https://skmtc.dev/lwolf/apis/zipform-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/zipform-partner-api/revisions/89796ac90fc6?raw)