POST

/person

Usage Notes

When

  • Create person records for bulk import from external systems
  • Set up persons for later association with multiple BizEntities
  • Direct person creation outside BizEntity workflow

Requirements

  • FirstName and LastName required
  • CRSFATCAParticipationID required (query Common/Lookup for values)

Notes

  • Email addresses must be unique across entire platform
  • Each address/communication links to only one person, organisation, or BizEntity
  • Use externalPersonId consistently to enable deduplication in future BizEntity operations
  • Cannot delete persons once active BizEntityParty relationships exist

Description

Creates a person record with identity, tax residency, and contact information. Use consistent externalPersonId values to prevent duplicate records when the same person later appears in BizEntity operations.

Required Headers - See Authentication

HeaderValueDescription
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier
Content-Typeapplication/jsonContent type for request body

Request Body

Parameter Type Required Description
PersonID
 integer
Optional
Must be null for new persons. System will assign unique PersonID upon successful creation.
externalPersonId
 string
Optional
Your external identifier for this person. Must be unique across your system if provided. Use for dual-ID integration.
firstName
 string
Optional
Given name as it appears on government-issued identification. Critical for identity verification and regulatory compliance.
middleName
 string
Optional
Middle name or additional given names if applicable. Include for complete legal identity.
lastName >
string(100)
Last name/family name as it appears on legal identification.
description
 string(2000)
Optional
Additional descriptive information about the person.
abn
 string
Optional
11-digit Australian Business Number if person operates as sole trader. Required for business income tax reporting and GST obligations.
birthCountryCode
 string
Optional
ISO 2-letter country code of birth country. Important for CRS/FATCA reporting and determining tax residency status.
crsfatcaParticipationID >
integer
CRS/FATCA participation classification. Critical for international tax reporting and compliance with global tax information exchange agreements.
customerCode
 string
Optional
Your internal customer reference code for linking to external systems and customer service operations.
dateOfBirth >
string (date)
Date of birth in YYYY-MM-DD format. Critical for compliance, age verification, and investment eligibility determination.
driversLicenseIssueCountryCode >
string
ISO country code of driver's license issuing authority. Essential for identity verification when driver's license is primary ID.
driversLicenseNumber
 string
Optional
Driver's license number for identity verification. Commonly used primary identification document for AML/KYC compliance.
gender
 string
Optional
Gender classification: M=Male, F=Female, X=Other/Not specified. Used for demographic reporting and compliance documentation.
identificationTypeID
 integer
Optional
Primary identification document type reference. Links to lookup table for passport, driver's license, national ID, etc. Critical for AML/KYC verification.
identificationValue
 string
Optional
Primary identification document number or value. Must correspond to the identification type specified. Used for identity verification and compliance checks.
isDirectorOfCorporateTrustee
 boolean
Optional
Indicates if person serves as director of corporate trustee for SMSF or managed investment schemes. Triggers enhanced compliance monitoring and fiduciary duty obligations.
isPEP
 boolean
Optional
Politically Exposed Person classification for enhanced due diligence. Includes government officials, their families, and close associates. Requires ongoing monitoring and enhanced compliance procedures.
isSophisticatedInvestor
 boolean
Optional
Sophisticated investor status under Australian Corporations Act. Provides access to wholesale investment products and reduced disclosure requirements. Requires certification and periodic review.
isTrustee
 boolean
Optional
Indicates if this person acts as a trustee for SMSF, family trust, or managed investment schemes. Triggers enhanced compliance monitoring and fiduciary responsibilities.
pepDescription >
string(500)
Description of PEP status and role if applicable.
legalGuardianTitleID >
integer
Title ID for legal guardian (required for minors). Links to lookup table for Mr, Mrs, Ms, Dr, etc.
legalGuardianFirstName >
string(100)
Legal guardian's first name (required for minors).
legalGuardianMiddleName
 string(100)
Optional
Legal guardian's middle name if applicable.
legalGuardianLastName >
string(100)
Legal guardian's last name (required for minors).
passportIssueCountryCode >
string
ISO country code of passport issuing authority. Essential for international clients and cross-border investment verification.
passportNumber
 string
Optional
Passport number for international identity verification. Primary ID for non-residents and cross-border investment compliance.
salutation
 string
Optional
Preferred name for correspondence and client communications. Use when different from legal first name for personalized service.
sharePercentage
 integer
Optional
Ownership percentage (0-100) for trust beneficiaries, company shareholders, or SMSF member allocations. Used for distribution calculations and beneficial ownership reporting.
sophisticatedInvestorCertificateDate >
string (date)
Certification date for sophisticated investor status in YYYY-MM-DD format. Must be current for wholesale product access.
taxationCountryCode
 string
Optional
Primary tax residency country (ISO 2-letter code). Determines main tax obligations and reporting requirements for investment income.
taxationCountryCode2
 string
Optional
Secondary tax residency country for dual tax residents. Triggers additional CRS/FATCA reporting obligations and compliance procedures.
taxationCountryCode3
 string
Optional
Third tax residency country for complex multi-jurisdiction tax residents. Requires enhanced CRS reporting and compliance monitoring.
taxationCountryTIN
 string
Optional
Tax Identification Number for primary tax residency country. Required for accurate tax reporting and CRS compliance in primary jurisdiction.
taxationCountryTIN2
 string
Optional
Tax Identification Number for secondary tax residency country. Essential for dual tax resident CRS/FATCA reporting compliance.
taxationCountryTIN3
 string
Optional
Tax Identification Number for third tax residency country. Required for complex multi-jurisdiction tax reporting compliance.
taxationCountryNoTINReason
 string
Optional
Explanation for absence of TIN in primary tax residency country. Required for CRS compliance when TIN unavailable (e.g., country doesn't issue TINs).
taxationCountryNoTINReason2
 string
Optional
Explanation for absence of TIN in secondary tax residency country. Required for dual resident CRS compliance.
taxationCountryNoTINReason3
 string
Optional
Explanation for absence of TIN in third tax residency country. Required for complex multi-jurisdiction CRS reporting.
taxationFileNumber >
string(9)
Australian Tax File Number (will be encrypted).
tradingName
 string
Optional
Business or trading name for sole trader operations. Used for business income reporting and GST registration where applicable.
taxOfficeTypeID
 integer
Optional
Tax authority type identifier for primary tax jurisdiction. Links to lookup table for ATO, IRS, HMRC, etc.
tin
 string
Optional
Foreign Tax Identification Number for international tax compliance. Used for non-Australian tax jurisdiction reporting.
titleID
 integer
Optional
Person's title reference via common/lookup. Used for formal correspondence and client communications.
addresses
> List<AddressDTO>...
Optional
Individual's address collection for postal delivery, residential verification, and compliance purposes. At least one primary residential address strongly recommended for AML/KYC compliance.
communications
> List<CommunicationDTO>...
Optional
Individual's communication methods for correspondence, compliance notifications, and contact purposes. Email communication strongly recommended for investment operations and regulatory notifications.
PersonID
integer
Optional
Must be null for new persons. System will assign unique PersonID upon successful creation.
externalPersonId
string
Optional
Your external identifier for this person. Must be unique across your system if provided. Use for dual-ID integration.
firstName
string
Optional
Given name as it appears on government-issued identification. Critical for identity verification and regulatory compliance.
middleName
string
Optional
Middle name or additional given names if applicable. Include for complete legal identity.
lastName
string(100)
Last name/family name as it appears on legal identification.
description
string(2000)
Optional
Additional descriptive information about the person.
abn
string
Optional
11-digit Australian Business Number if person operates as sole trader. Required for business income tax reporting and GST obligations.
birthCountryCode
string
Optional
ISO 2-letter country code of birth country. Important for CRS/FATCA reporting and determining tax residency status.
crsfatcaParticipationID
integer
CRS/FATCA participation classification. Critical for international tax reporting and compliance with global tax information exchange agreements.
customerCode
string
Optional
Your internal customer reference code for linking to external systems and customer service operations.
dateOfBirth
string (date)
Date of birth in YYYY-MM-DD format. Critical for compliance, age verification, and investment eligibility determination.
driversLicenseIssueCountryCode
string
ISO country code of driver's license issuing authority. Essential for identity verification when driver's license is primary ID.
driversLicenseNumber
string
Optional
Driver's license number for identity verification. Commonly used primary identification document for AML/KYC compliance.
gender
string
Optional
Gender classification: M=Male, F=Female, X=Other/Not specified. Used for demographic reporting and compliance documentation.
identificationTypeID
integer
Optional
Primary identification document type reference. Links to lookup table for passport, driver's license, national ID, etc. Critical for AML/KYC verification.
identificationValue
string
Optional
Primary identification document number or value. Must correspond to the identification type specified. Used for identity verification and compliance checks.
isDirectorOfCorporateTrustee
boolean
Optional
Indicates if person serves as director of corporate trustee for SMSF or managed investment schemes. Triggers enhanced compliance monitoring and fiduciary duty obligations.
isPEP
boolean
Optional
Politically Exposed Person classification for enhanced due diligence. Includes government officials, their families, and close associates. Requires ongoing monitoring and enhanced compliance procedures.
isSophisticatedInvestor
boolean
Optional
Sophisticated investor status under Australian Corporations Act. Provides access to wholesale investment products and reduced disclosure requirements. Requires certification and periodic review.
isTrustee
boolean
Optional
Indicates if this person acts as a trustee for SMSF, family trust, or managed investment schemes. Triggers enhanced compliance monitoring and fiduciary responsibilities.
pepDescription
string(500)
Description of PEP status and role if applicable.
legalGuardianTitleID
integer
Title ID for legal guardian (required for minors). Links to lookup table for Mr, Mrs, Ms, Dr, etc.
legalGuardianFirstName
string(100)
Legal guardian's first name (required for minors).
legalGuardianMiddleName
string(100)
Optional
Legal guardian's middle name if applicable.
legalGuardianLastName
string(100)
Legal guardian's last name (required for minors).
passportIssueCountryCode
string
ISO country code of passport issuing authority. Essential for international clients and cross-border investment verification.
passportNumber
string
Optional
Passport number for international identity verification. Primary ID for non-residents and cross-border investment compliance.
salutation
string
Optional
Preferred name for correspondence and client communications. Use when different from legal first name for personalized service.
sharePercentage
integer
Optional
Ownership percentage (0-100) for trust beneficiaries, company shareholders, or SMSF member allocations. Used for distribution calculations and beneficial ownership reporting.
sophisticatedInvestorCertificateDate
string (date)
Certification date for sophisticated investor status in YYYY-MM-DD format. Must be current for wholesale product access.
taxationCountryCode
string
Optional
Primary tax residency country (ISO 2-letter code). Determines main tax obligations and reporting requirements for investment income.
taxationCountryCode2
string
Optional
Secondary tax residency country for dual tax residents. Triggers additional CRS/FATCA reporting obligations and compliance procedures.
taxationCountryCode3
string
Optional
Third tax residency country for complex multi-jurisdiction tax residents. Requires enhanced CRS reporting and compliance monitoring.
taxationCountryTIN
string
Optional
Tax Identification Number for primary tax residency country. Required for accurate tax reporting and CRS compliance in primary jurisdiction.
taxationCountryTIN2
string
Optional
Tax Identification Number for secondary tax residency country. Essential for dual tax resident CRS/FATCA reporting compliance.
taxationCountryTIN3
string
Optional
Tax Identification Number for third tax residency country. Required for complex multi-jurisdiction tax reporting compliance.
taxationCountryNoTINReason
string
Optional
Explanation for absence of TIN in primary tax residency country. Required for CRS compliance when TIN unavailable (e.g., country doesn't issue TINs).
taxationCountryNoTINReason2
string
Optional
Explanation for absence of TIN in secondary tax residency country. Required for dual resident CRS compliance.
taxationCountryNoTINReason3
string
Optional
Explanation for absence of TIN in third tax residency country. Required for complex multi-jurisdiction CRS reporting.
taxationFileNumber
string(9)
Australian Tax File Number (will be encrypted).
tradingName
string
Optional
Business or trading name for sole trader operations. Used for business income reporting and GST registration where applicable.
taxOfficeTypeID
integer
Optional
Tax authority type identifier for primary tax jurisdiction. Links to lookup table for ATO, IRS, HMRC, etc.
tin
string
Optional
Foreign Tax Identification Number for international tax compliance. Used for non-Australian tax jurisdiction reporting.
titleID
integer
Optional
Person's title reference via common/lookup. Used for formal correspondence and client communications.
addresses
> List<AddressDTO>...
Optional
Individual's address collection for postal delivery, residential verification, and compliance purposes. At least one primary residential address strongly recommended for AML/KYC compliance.
communications
> List<CommunicationDTO>...
Optional
Individual's communication methods for correspondence, compliance notifications, and contact purposes. Email communication strongly recommended for investment operations and regulatory notifications.

Identity Verification

For AML/KYC compliance, ensure you collect and verify:

  • Full Legal Name: As it appears on government-issued ID
  • Date of Birth: For age verification and compliance
  • Residential Address: Not a PO Box for primary address
  • Tax Information: TFN for Australian residents, foreign tax details for others

Example Requests

bash
curl -X POST https://api.7g.com.au/person \
  -H "Content-Type: application/json" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0" \
  -d '{
    "personID": 0,
    "externalPersonId": "EXT-PERSON-001",
    "firstName": "John",
    "middleName": "William",
    "lastName": "Smith",
    "description": "Senior financial advisor",
    "abn": "12345678901",
    "birthCountryCode": "AUS",
    "crsfatcaParticipationID": 1,
    "customerCode": "CUST-001",
    "dateOfBirth": "1975-03-15",
    "driversLicenseIssueCountryCode": "AUS",
    "driversLicenseNumber": "DL123456789",
    "gender": "M",
    "identificationTypeID": 1,
    "identificationValue": "DL123456789",
    "isDirectorOfCorporateTrustee": true,
    "isPEP": false,
    "isSophisticatedInvestor": true,
    "isTrustee": true,
    "passportIssueCountryCode": "AUS",
    "passportNumber": "A12345678",
    "salutation": "John",
    "sharePercentage": 25,
    "sophisticatedInvestorCertificateDate": "2024-01-15",
    "taxationCountryCode": "AUS",
    "taxationCountryCode2": "US",
    "taxationCountryTIN": "123456789",
    "taxationCountryTIN2": "US123456789",
    "taxationFileNumber": "123456789",
    "tradingName": "Smith Consulting",
    "taxOfficeTypeID": 1,
    "tin": "US123456789",
    "titleID": 1
  }'

Response Examples

json
{
  "result": true,
  "message": "Person created successfully",
  "recordCount": 1,
  "data": [
    {
      "personID": 12345,
      "externalPersonId": "EXT-PERSON-001",
      "firstName": "John",
      "middleName": "William",
      "lastName": "Smith",
      "description": "Senior financial advisor and SMSF trustee",
      "abn": "12345678901",
      "birthCountryCode": "AUS",
      "crsfatcaParticipationID": 1,
      "customerCode": "CUST-001",
      "dateOfBirth": "1975-03-15",
      "driversLicenseIssueCountryCode": "AUS",
      "driversLicenseNumber": "DL123456789",
      "gender": "M",
      "identificationTypeID": 1,
      "identificationValue": "DL123456789",
      "isDirectorOfCorporateTrustee": true,
      "isPEP": false,
      "isSophisticatedInvestor": true,
      "isTrustee": true,
      "pepDescription": null,
      "legalGuardianTitleID": null,
      "legalGuardianFirstName": null,
      "legalGuardianMiddleName": null,
      "legalGuardianLastName": null,
      "passportIssueCountryCode": "AUS",
      "passportNumber": "A12345678",
      "salutation": "John",
      "sharePercentage": 25,
      "sophisticatedInvestorCertificateDate": "2024-01-15",
      "taxationCountryCode": "AUS",
      "taxationCountryCode2": "US",
      "taxationCountryCode3": null,
      "taxationCountryTIN": "***456789",
      "taxationCountryTIN2": "US***56789",
      "taxationCountryTIN3": null,
      "taxationCountryNoTINReason": null,
      "taxationCountryNoTINReason2": null,
      "taxationCountryNoTINReason3": null,
      "taxationFileNumber": "***456789",
      "tradingName": "Smith Consulting",
      "taxOfficeTypeID": 1,
      "tin": "US***56789",
      "titleID": 1,
      "addresses": [
        {
          "addressID": 456,
          "addressTypeID": 1,
          "aboveAddressLine": "123 Main Street",
          "addressLine": "Suite 10",
          "suburb": "Sydney",
          "postcode": "2000",
          "stateCode": "NSW",
          "countryCode": "AUS",
          "externalAddressId": null,
          "externalBizEntityId": null,
          "externalPersonId": "EXT-PERSON-001",
          "externalOrganisationId": null,
          "personID": 12345,
          "bizEntityID": 0,
          "organisationID": 0
        }
      ],
      "communications": [
        {
          "communicationID": 789,
          "externalCommunicationId": null,
          "communicationTypeID": 1,
          "name": "0412345678",
          "bizEntityID": 0,
          "externalBizEntityId": null,
          "personID": 12345,
          "externalPersonId": "EXT-PERSON-001",
          "organisationID": 0,
          "externalOrganisationId": null
        },
        {
          "communicationID": 790,
          "externalCommunicationId": null,
          "communicationTypeID": 2,
          "name": "john.smith@example.com",
          "bizEntityID": 0,
          "externalBizEntityId": null,
          "personID": 12345,
          "externalPersonId": "EXT-PERSON-001",
          "organisationID": 0,
          "externalOrganisationId": null
        }
      ]
    }
  ]
}
GET Get Persons PUT Update Person POST Create BizEntity