---
title: "Upsert Emergency Contacts"
method: PUT
path: "/v2/companies/{companyId}/employees/{employeeId}/emergencyContacts"
tags: ["Emergency Contacts"]
---

# Upsert Emergency Contacts

`PUT /v2/companies/{companyId}/employees/{employeeId}/emergencyContacts`

## Request

- Base URL: `https://dc1demogw.paylocity.com/api`
- URL: `https://dc1demogw.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}/emergencyContacts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.paylocity.com/IdentityServer/connect/token` scopes: `WebLinkAPI`

Sends new or updated employee emergency contacts directly to Paylocity Payroll/HR solution.

## Path parameters

- `companyId` string, required
- `employeeId` string, required

## Request body

- EmergencyContact: The emergency contact model
  - `address1` string: 1st address line.
  - `address2` string: 2nd address line.
  - `city` string: City.
  - `country` string: County.
  - `county` string: Country. Must be a valid 3 character country code. Common values are *USA* (United States), *CAN* (Canada).
  - `email` string: Contact email. Must be valid email address format.
  - `firstName` string, required: Required. Contact first name. <br />Max length: 40
  - `homePhone` string: Contact Home Phone. Valid phone format *(###) #######* or *######-####* or *### ### ####* or *##########* or, if international, starts with *+#*, only spaces and digits allowed.
  - `lastName` string, required: Required. Contact last name. <br />Max length: 40
  - `mobilePhone` string: Contact Mobile Phone. Valid phone format *(###) #######* or *######-####* or *### ### ####* or *##########* or, if international, starts with *+#*, only spaces and digits allowed.
  - `notes` string: Notes. <br />Max length: 1000
  - `pager` string: Contact Pager. Valid phone format *(###) #######* or *######-####* or *### ### ####* or *##########* or, if international, starts with *+#*, only spaces and digits allowed.
  - `primaryPhone` string: Required. Contact primary phone type. Must match Company setup. Valid values are H (Home), M (Mobile), P (Pager), W (Work)
  - `priority` string: Required. Contact priority. Valid values are *P* (Primary) or *S* (Secondary).
  - `relationship` string: Required. Contact relationship. Must match Company setup. Common values are Spouse, Mother, Father.
  - `state` string: State or Province. If U.S. address, must be valid 2 character state code. Common values are *IL* (Illinois), *CA* (California).
  - `syncEmployeeInfo` boolean: Valid values are *true* or *false*.
  - `workExtension` string: Work Extension.
  - `workPhone` string: Contact Work Phone. Valid phone format *(###) #######* or *######-####* or *### ### ####* or *##########* or, if international, starts with *+#*, only spaces and digits allowed.
  - `zip` string: Postal code. If U.S. address, must be a valid zip code.

## Response `200`

Successfully added or updated

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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