Create user email

Attach an additional email address to a Greenhouse user — the V3 replacement for V1 POST /users/{id}/email_addresses. This only adds secondary addresses; it cannot change the user's primary email or replace an existing address. Emails are globally unique across users, so attempting to attach an address that already belongs to anyone returns 409. Re-posting an address that already exists on the target user with send_verification=true while it is still unverified resends the verification email and returns 200 instead of 201.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required

Id of the user to attach this email to.

string
required

Email address to add to the user. Must not already be attached to any user in Greenhouse; emails are case-insensitive and globally unique.

boolean
Defaults to false

When true, sends the user a verification email and leaves the new address unverified until they confirm. When false (the default), the address is added unverified and no email is sent; the user can verify it later. Re-posting the same address with send_verification=true while the existing record is still unverified resends the verification email and returns 200; other duplicates return 409.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json