Contacts

Create a contact

post/contacts

Request

Base URL: https://next-api.saturation.io/v1
URL: https://next-api.saturation.io/v1/contacts
Auth: HTTP bearer

Headers

Idempotency-Keystring required

Unique request key, 16 to 255 characters. Retrying the same request returns the first response. Missing or invalid keys return 400 validation; reuse with a different body returns 409 idempotency_conflict.

Request body

namestring required

companystring nullable

titlestring nullable

type'contractor' | 'employee' | 'company' | 'vendor'

Contact type. Vendors are organizations; contractors and employees are people.

emailstring nullable

phonestring nullable

addressstring nullable

websitestring nullable

instagramstring nullable

imdbstring nullable

track1099boolean

notesstring nullable

Example request

{
  "rate": {
    "amount": 152900,
    "currency": "USD"
  }
}

Response

The created contact.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

displayNamestring required

Display name for the contact.

namestring nullable

Person or primary contact name.

companystring nullable

titlestring nullable

Role or job title, such as Director of Photography.

type'contractor' | 'employee' | 'company' | 'vendor'

Contact type. Vendors are organizations; contractors and employees are people.

emailstring nullable

phonestring nullable

addressstring nullable

Free-form address as entered.

websitestring nullable

instagramstring nullable

imdbstring nullable

track1099boolean required

Whether this contact is tracked for 1099 reporting.

taxIdLast4string nullable

Last four digits of the tax ID.

hasTaxIdboolean

Whether a tax ID is on file.

notesstring nullable

Markdown notes.

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "txn_8f2a1c9e",
  "displayName": "Aerial Imaging LLC",
  "rate": {
    "amount": 152900,
    "currency": "USD"
  },
  "documents": [
    {
      "id": "txn_8f2a1c9e"
    }
  ],
  "transactions": [
    {
      "id": "txn_8f2a1c9e",
      "projectId": "txn_8f2a1c9e",
      "budgetLineId": "txn_8f2a1c9e"
    }
  ]
}

Changes

Changes to this operation have not been checked yet.