Create a person

POST

households

{household_id}

people

Create a person

curl --request POST \
  --url https://api.slant.app/v1/households/{household_id}/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "Robert",
  "preferred_name": "Johnny",
  "salutation": "Mr.",
  "suffix": "Jr.",
  "gender": "male",
  "designations": "CPA, CFP",
  "household_role": "spouse",
  "date_of_birth": "1985-06-15",
  "job_title": "Software Engineer",
  "email_addresses": [
    {
      "email": "john@example.com",
      "email_type": "personal",
      "is_primary": true
    }
  ],
  "phone_numbers": [
    {
      "phone_number": "+15555551234",
      "phone_type": "mobile",
      "is_primary": true
    }
  ],
  "addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country_code": "US",
      "address_type": "home",
      "is_primary": true
    }
  ],
  "employments": [
    {
      "business_name": "Acme Corp",
      "role": "Software Engineer",
      "start_date": "2023-01-15",
      "end_date": "2024-12-31",
      "actively_employed": true
    }
  ],
  "ssn": "123-45-6789",
  "drivers_license_number": "DL-1234567890",
  "custom_fields": {
    "preferred_contact_method": "Email"
  }
}
'

import requests

url = "https://api.slant.app/v1/households/{household_id}/people"

payload = {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "Robert",
    "preferred_name": "Johnny",
    "salutation": "Mr.",
    "suffix": "Jr.",
    "gender": "male",
    "designations": "CPA, CFP",
    "household_role": "spouse",
    "date_of_birth": "1985-06-15",
    "job_title": "Software Engineer",
    "email_addresses": [
        {
            "email": "john@example.com",
            "email_type": "personal",
            "is_primary": True
        }
    ],
    "phone_numbers": [
        {
            "phone_number": "+15555551234",
            "phone_type": "mobile",
            "is_primary": True
        }
    ],
    "addresses": [
        {
            "line1": "123 Main St",
            "line2": "Apt 4B",
            "city": "New York",
            "state": "NY",
            "zip": "10001",
            "country_code": "US",
            "address_type": "home",
            "is_primary": True
        }
    ],
    "employments": [
        {
            "business_name": "Acme Corp",
            "role": "Software Engineer",
            "start_date": "2023-01-15",
            "end_date": "2024-12-31",
            "actively_employed": True
        }
    ],
    "ssn": "123-45-6789",
    "drivers_license_number": "DL-1234567890",
    "custom_fields": { "preferred_contact_method": "Email" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'John',
    last_name: 'Doe',
    middle_name: 'Robert',
    preferred_name: 'Johnny',
    salutation: 'Mr.',
    suffix: 'Jr.',
    gender: 'male',
    designations: 'CPA, CFP',
    household_role: 'spouse',
    date_of_birth: '1985-06-15',
    job_title: 'Software Engineer',
    email_addresses: [{email: 'john@example.com', email_type: 'personal', is_primary: true}],
    phone_numbers: [{phone_number: '+15555551234', phone_type: 'mobile', is_primary: true}],
    addresses: [
      {
        line1: '123 Main St',
        line2: 'Apt 4B',
        city: 'New York',
        state: 'NY',
        zip: '10001',
        country_code: 'US',
        address_type: 'home',
        is_primary: true
      }
    ],
    employments: [
      {
        business_name: 'Acme Corp',
        role: 'Software Engineer',
        start_date: '2023-01-15',
        end_date: '2024-12-31',
        actively_employed: true
      }
    ],
    ssn: '123-45-6789',
    drivers_license_number: 'DL-1234567890',
    custom_fields: {preferred_contact_method: 'Email'}
  })
};

fetch('https://api.slant.app/v1/households/{household_id}/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.slant.app/v1/households/{household_id}/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'John',
    'last_name' => 'Doe',
    'middle_name' => 'Robert',
    'preferred_name' => 'Johnny',
    'salutation' => 'Mr.',
    'suffix' => 'Jr.',
    'gender' => 'male',
    'designations' => 'CPA, CFP',
    'household_role' => 'spouse',
    'date_of_birth' => '1985-06-15',
    'job_title' => 'Software Engineer',
    'email_addresses' => [
        [
                'email' => 'john@example.com',
                'email_type' => 'personal',
                'is_primary' => true
        ]
    ],
    'phone_numbers' => [
        [
                'phone_number' => '+15555551234',
                'phone_type' => 'mobile',
                'is_primary' => true
        ]
    ],
    'addresses' => [
        [
                'line1' => '123 Main St',
                'line2' => 'Apt 4B',
                'city' => 'New York',
                'state' => 'NY',
                'zip' => '10001',
                'country_code' => 'US',
                'address_type' => 'home',
                'is_primary' => true
        ]
    ],
    'employments' => [
        [
                'business_name' => 'Acme Corp',
                'role' => 'Software Engineer',
                'start_date' => '2023-01-15',
                'end_date' => '2024-12-31',
                'actively_employed' => true
        ]
    ],
    'ssn' => '123-45-6789',
    'drivers_license_number' => 'DL-1234567890',
    'custom_fields' => [
        'preferred_contact_method' => 'Email'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slant.app/v1/households/{household_id}/people"

	payload := strings.NewReader("{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.slant.app/v1/households/{household_id}/people")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.slant.app/v1/households/{household_id}/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "abc123xyz",
  "book_id": "book123xyz",
  "first_name": "John",
  "last_name": "Doe",
  "household_id": "xyz789abc",
  "contact_id": "cnt456def",
  "role_type": "client",
  "middle_name": "Robert",
  "salutation": "Mr.",
  "suffix": "Jr.",
  "maiden_name": "Smith",
  "gender": "male",
  "designations": "CPA, CFP",
  "household_role": "head_of_household",
  "preferred_name": "Johnny",
  "date_of_birth": "1985-06-15",
  "job_title": "Software Engineer",
  "ssn": "***-**-6789",
  "drivers_license_number": "******7890",
  "email_addresses": [
    {
      "email": "john.doe@example.com",
      "email_type": "personal",
      "is_primary": true
    }
  ],
  "phone_numbers": [
    {
      "phone_number": "+15555551234",
      "phone_type": "mobile",
      "is_primary": true,
      "extension": "1234"
    }
  ],
  "addresses": [
    {
      "address_type": "home",
      "is_primary": true,
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country_code": "US"
    }
  ],
  "employments": [
    {
      "business_name": "Acme Corp",
      "id": "emp123xyz",
      "person_id": "abc123xyz",
      "role": "Software Engineer",
      "start_date": "2023-01-15",
      "end_date": "2024-12-31",
      "actively_employed": true
    }
  ],
  "custom_fields": {
    "preferred_contact_method": "Email",
    "risk_tolerance": "Moderate"
  }
}

{
  "error": "invalid_json",
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth 2.0 Bearer Token from Clerk authentication

Headers

Idempotency-Key

string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Path Parameters

household_id

string

required

The household ID

Body

application/json

first_name

string

required

First name

Example:

"John"

last_name

string

required

Last name

Example:

"Doe"

middle_name

string

Middle name

Example:

"Robert"

preferred_name

string

Preferred name

Example:

"Johnny"

salutation

string

Salutation

Example:

"Mr."

suffix

string

Suffix

Example:

"Jr."

gender

enum<string>

Gender

Available options:

female,

male,

nonbinary,

other,

prefer_not_to_say

Example:

"male"

designations

string

Professional designations

Example:

"CPA, CFP"

household_role

enum<string>

Role in the household

Available options:

head_of_household,

partner,

spouse,

dependent_child,

other_adult,

non_dependent_child,

other_dependent,

unknown,

deceased,

grandchild

Example:

"spouse"

date_of_birth

string<date>

Date of birth

Example:

"1985-06-15"

job_title

string

Job title

Example:

"Software Engineer"

email_addresses

object[]

Array of email addresses

Show child attributes

phone_numbers

object[]

Array of phone numbers

Show child attributes

addresses

object[]

Array of addresses

Show child attributes

employments

object[]

Array of employment records

Show child attributes

ssn

string

Social security number

Example:

"123-45-6789"

drivers_license_number

string

Driver's license number

Example:

"DL-1234567890"

custom_fields

object

Custom field values as key-value pairs

Example:

{ "preferred_contact_method": "Email" }

Response

person created

string

required

The person ID

Example:

"abc123xyz"

book_id

string

required

The book ID

Example:

"book123xyz"

first_name

string

required

Example:

"John"

last_name

string

required

Example:

"Doe"

household_id

string | null

The household ID

Example:

"xyz789abc"

contact_id

string | null

The contact ID (present when person belongs to a contact)

Example:

"cnt456def"

role_type

enum<string> | null

The entity type this person belongs to

Available options:

client,

prospect,

contact,

past_client

Example:

"client"

middle_name

string | null

Example:

"Robert"

salutation

string | null

Example:

"Mr."

suffix

string | null

Example:

"Jr."

maiden_name

string | null

Example:

"Smith"

gender

enum<string> | null

Available options:

female,

male,

nonbinary,

other,

prefer_not_to_say

Example:

"male"

designations

string | null

Example:

"CPA, CFP"

household_role

enum<string> | null

Only present when person belongs to a household

Available options:

head_of_household,

partner,

spouse,

dependent_child,

other_adult,

other_dependent,

unknown,

deceased,

non_dependent_child,

grandchild

Example:

"head_of_household"

preferred_name

string | null

Example:

"Johnny"

date_of_birth

string<date> | null

Date of birth

Example:

"1985-06-15"

job_title

string | null

Job title

Example:

"Software Engineer"

ssn

string | null

Obfuscated social security number

Example:

"***-**-6789"

drivers_license_number

string | null

Obfuscated driver's license number

Example:

"******7890"

email_addresses

object[]

Array of email addresses with primary designation

Show child attributes

phone_numbers

object[]

Array of phone numbers with primary designation

Show child attributes

addresses

object[]

Array of addresses with primary designation

Show child attributes

employments

object[]

Array of employment records

Show child attributes

custom_fields

object

Custom field values as key-value pairs

Example:

{
  "preferred_contact_method": "Email",
  "risk_tolerance": "Moderate"
}

Get a personRetrieve a person by ID

⌘I

Create a person

curl --request POST \
  --url https://api.slant.app/v1/households/{household_id}/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "Robert",
  "preferred_name": "Johnny",
  "salutation": "Mr.",
  "suffix": "Jr.",
  "gender": "male",
  "designations": "CPA, CFP",
  "household_role": "spouse",
  "date_of_birth": "1985-06-15",
  "job_title": "Software Engineer",
  "email_addresses": [
    {
      "email": "john@example.com",
      "email_type": "personal",
      "is_primary": true
    }
  ],
  "phone_numbers": [
    {
      "phone_number": "+15555551234",
      "phone_type": "mobile",
      "is_primary": true
    }
  ],
  "addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country_code": "US",
      "address_type": "home",
      "is_primary": true
    }
  ],
  "employments": [
    {
      "business_name": "Acme Corp",
      "role": "Software Engineer",
      "start_date": "2023-01-15",
      "end_date": "2024-12-31",
      "actively_employed": true
    }
  ],
  "ssn": "123-45-6789",
  "drivers_license_number": "DL-1234567890",
  "custom_fields": {
    "preferred_contact_method": "Email"
  }
}
'

import requests

url = "https://api.slant.app/v1/households/{household_id}/people"

payload = {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "Robert",
    "preferred_name": "Johnny",
    "salutation": "Mr.",
    "suffix": "Jr.",
    "gender": "male",
    "designations": "CPA, CFP",
    "household_role": "spouse",
    "date_of_birth": "1985-06-15",
    "job_title": "Software Engineer",
    "email_addresses": [
        {
            "email": "john@example.com",
            "email_type": "personal",
            "is_primary": True
        }
    ],
    "phone_numbers": [
        {
            "phone_number": "+15555551234",
            "phone_type": "mobile",
            "is_primary": True
        }
    ],
    "addresses": [
        {
            "line1": "123 Main St",
            "line2": "Apt 4B",
            "city": "New York",
            "state": "NY",
            "zip": "10001",
            "country_code": "US",
            "address_type": "home",
            "is_primary": True
        }
    ],
    "employments": [
        {
            "business_name": "Acme Corp",
            "role": "Software Engineer",
            "start_date": "2023-01-15",
            "end_date": "2024-12-31",
            "actively_employed": True
        }
    ],
    "ssn": "123-45-6789",
    "drivers_license_number": "DL-1234567890",
    "custom_fields": { "preferred_contact_method": "Email" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'John',
    last_name: 'Doe',
    middle_name: 'Robert',
    preferred_name: 'Johnny',
    salutation: 'Mr.',
    suffix: 'Jr.',
    gender: 'male',
    designations: 'CPA, CFP',
    household_role: 'spouse',
    date_of_birth: '1985-06-15',
    job_title: 'Software Engineer',
    email_addresses: [{email: 'john@example.com', email_type: 'personal', is_primary: true}],
    phone_numbers: [{phone_number: '+15555551234', phone_type: 'mobile', is_primary: true}],
    addresses: [
      {
        line1: '123 Main St',
        line2: 'Apt 4B',
        city: 'New York',
        state: 'NY',
        zip: '10001',
        country_code: 'US',
        address_type: 'home',
        is_primary: true
      }
    ],
    employments: [
      {
        business_name: 'Acme Corp',
        role: 'Software Engineer',
        start_date: '2023-01-15',
        end_date: '2024-12-31',
        actively_employed: true
      }
    ],
    ssn: '123-45-6789',
    drivers_license_number: 'DL-1234567890',
    custom_fields: {preferred_contact_method: 'Email'}
  })
};

fetch('https://api.slant.app/v1/households/{household_id}/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.slant.app/v1/households/{household_id}/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'John',
    'last_name' => 'Doe',
    'middle_name' => 'Robert',
    'preferred_name' => 'Johnny',
    'salutation' => 'Mr.',
    'suffix' => 'Jr.',
    'gender' => 'male',
    'designations' => 'CPA, CFP',
    'household_role' => 'spouse',
    'date_of_birth' => '1985-06-15',
    'job_title' => 'Software Engineer',
    'email_addresses' => [
        [
                'email' => 'john@example.com',
                'email_type' => 'personal',
                'is_primary' => true
        ]
    ],
    'phone_numbers' => [
        [
                'phone_number' => '+15555551234',
                'phone_type' => 'mobile',
                'is_primary' => true
        ]
    ],
    'addresses' => [
        [
                'line1' => '123 Main St',
                'line2' => 'Apt 4B',
                'city' => 'New York',
                'state' => 'NY',
                'zip' => '10001',
                'country_code' => 'US',
                'address_type' => 'home',
                'is_primary' => true
        ]
    ],
    'employments' => [
        [
                'business_name' => 'Acme Corp',
                'role' => 'Software Engineer',
                'start_date' => '2023-01-15',
                'end_date' => '2024-12-31',
                'actively_employed' => true
        ]
    ],
    'ssn' => '123-45-6789',
    'drivers_license_number' => 'DL-1234567890',
    'custom_fields' => [
        'preferred_contact_method' => 'Email'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slant.app/v1/households/{household_id}/people"

	payload := strings.NewReader("{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.slant.app/v1/households/{household_id}/people")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.slant.app/v1/households/{household_id}/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"middle_name\": \"Robert\",\n  \"preferred_name\": \"Johnny\",\n  \"salutation\": \"Mr.\",\n  \"suffix\": \"Jr.\",\n  \"gender\": \"male\",\n  \"designations\": \"CPA, CFP\",\n  \"household_role\": \"spouse\",\n  \"date_of_birth\": \"1985-06-15\",\n  \"job_title\": \"Software Engineer\",\n  \"email_addresses\": [\n    {\n      \"email\": \"john@example.com\",\n      \"email_type\": \"personal\",\n      \"is_primary\": true\n    }\n  ],\n  \"phone_numbers\": [\n    {\n      \"phone_number\": \"+15555551234\",\n      \"phone_type\": \"mobile\",\n      \"is_primary\": true\n    }\n  ],\n  \"addresses\": [\n    {\n      \"line1\": \"123 Main St\",\n      \"line2\": \"Apt 4B\",\n      \"city\": \"New York\",\n      \"state\": \"NY\",\n      \"zip\": \"10001\",\n      \"country_code\": \"US\",\n      \"address_type\": \"home\",\n      \"is_primary\": true\n    }\n  ],\n  \"employments\": [\n    {\n      \"business_name\": \"Acme Corp\",\n      \"role\": \"Software Engineer\",\n      \"start_date\": \"2023-01-15\",\n      \"end_date\": \"2024-12-31\",\n      \"actively_employed\": true\n    }\n  ],\n  \"ssn\": \"123-45-6789\",\n  \"drivers_license_number\": \"DL-1234567890\",\n  \"custom_fields\": {\n    \"preferred_contact_method\": \"Email\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "abc123xyz",
  "book_id": "book123xyz",
  "first_name": "John",
  "last_name": "Doe",
  "household_id": "xyz789abc",
  "contact_id": "cnt456def",
  "role_type": "client",
  "middle_name": "Robert",
  "salutation": "Mr.",
  "suffix": "Jr.",
  "maiden_name": "Smith",
  "gender": "male",
  "designations": "CPA, CFP",
  "household_role": "head_of_household",
  "preferred_name": "Johnny",
  "date_of_birth": "1985-06-15",
  "job_title": "Software Engineer",
  "ssn": "***-**-6789",
  "drivers_license_number": "******7890",
  "email_addresses": [
    {
      "email": "john.doe@example.com",
      "email_type": "personal",
      "is_primary": true
    }
  ],
  "phone_numbers": [
    {
      "phone_number": "+15555551234",
      "phone_type": "mobile",
      "is_primary": true,
      "extension": "1234"
    }
  ],
  "addresses": [
    {
      "address_type": "home",
      "is_primary": true,
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country_code": "US"
    }
  ],
  "employments": [
    {
      "business_name": "Acme Corp",
      "id": "emp123xyz",
      "person_id": "abc123xyz",
      "role": "Software Engineer",
      "start_date": "2023-01-15",
      "end_date": "2024-12-31",
      "actively_employed": true
    }
  ],
  "custom_fields": {
    "preferred_contact_method": "Email",
    "risk_tolerance": "Moderate"
  }
}

{
  "error": "invalid_json",
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Getting started

Endpoints

Authorizations

Headers

Path Parameters

Body

Response