POST
/
accounting
/
contacts
import { Panora } from "@panora/sdk";

const panora = new Panora({
  apiKey: "<YOUR_API_KEY_HERE>",
});

async function run() {
  const result = await panora.accounting.contacts.create({
    xConnectionToken: "<value>",
    remoteData: false,
    unifiedAccountingContactInput: {
      name: "John Doe",
      isSupplier: true,
      isCustomer: false,
      emailAddress: "john.doe@example.com",
      taxNumber: "123456789",
      status: "Active",
      currency: "USD",
      remoteUpdatedAt: "2024-06-15T12:00:00Z",
      companyInfoId: "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
      fieldMappings: {},
    },
  });
  
  // Handle the result
  console.log(result)
}

run();
{
  "name": "John Doe",
  "is_supplier": true,
  "is_customer": false,
  "email_address": "john.doe@example.com",
  "tax_number": "123456789",
  "status": "Active",
  "currency": "USD",
  "remote_updated_at": "2024-06-15T12:00:00Z",
  "company_info_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "field_mappings": {
    "custom_field_1": "value1",
    "custom_field_2": "value2"
  },
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "contact_1234",
  "remote_data": {
    "raw_data": {
      "additional_field": "some value"
    }
  },
  "created_at": "2024-06-15T12:00:00Z",
  "modified_at": "2024-06-15T12:00:00Z"
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-connection-token
string
required

The connection token

Query Parameters

​
remote_data
boolean

Set to true to include data from the original Accounting software.

Body

application/json
​
name
string | null

The name of the contact

Example:

"John Doe"

​
is_supplier
boolean | null

Indicates if the contact is a supplier

Example:

true

​
is_customer
boolean | null

Indicates if the contact is a customer

Example:

false

​
email_address
string | null

The email address of the contact

Example:

"john.doe@example.com"

​
tax_number
string | null

The tax number of the contact

Example:

"123456789"

​
status
string | null

The status of the contact

Example:

"Active"

​
currency
string | null

The currency associated with the contact

Example:

"USD"

​
remote_updated_at
string | null

The date when the contact was last updated in the remote system

Example:

"2024-06-15T12:00:00Z"

​
company_info_id
string | null

The UUID of the associated company info

Example:

"801f9ede-c698-4e66-a7fc-48d19eebaa4f"

​
field_mappings
object | null

The custom field mappings of the object between the remote 3rd party & Panora

Example:
{
  "custom_field_1": "value1",
  "custom_field_2": "value2"
}

Response

201 - application/json
​
name
string | null

The name of the contact

Example:

"John Doe"

​
is_supplier
boolean | null

Indicates if the contact is a supplier

Example:

true

​
is_customer
boolean | null

Indicates if the contact is a customer

Example:

false

​
email_address
string | null

The email address of the contact

Example:

"john.doe@example.com"

​
tax_number
string | null

The tax number of the contact

Example:

"123456789"

​
status
string | null

The status of the contact

Example:

"Active"

​
currency
string | null

The currency associated with the contact

Example:

"USD"

​
remote_updated_at
string | null

The date when the contact was last updated in the remote system

Example:

"2024-06-15T12:00:00Z"

​
company_info_id
string | null

The UUID of the associated company info

Example:

"801f9ede-c698-4e66-a7fc-48d19eebaa4f"

​
field_mappings
object | null

The custom field mappings of the object between the remote 3rd party & Panora

Example:
{
  "custom_field_1": "value1",
  "custom_field_2": "value2"
}
​
id
string | null

The UUID of the contact record

Example:

"801f9ede-c698-4e66-a7fc-48d19eebaa4f"

​
remote_id
string | null

The remote ID of the contact in the context of the 3rd Party

Example:

"contact_1234"

​
remote_data
object | null

The remote data of the contact in the context of the 3rd Party

Example:
{
  "raw_data": { "additional_field": "some value" }
}
​
created_at
string | null

The created date of the contact record

Example:

"2024-06-15T12:00:00Z"

​
modified_at
string | null

The last modified date of the contact record

Example:

"2024-06-15T12:00:00Z"