POST

/Person

When to Use

  • Create individual person records independently of BizEntity operations
  • Bulk import person data from external systems
  • Set up person records for later association with multiple entities
  • Manage cross-entity person relationships

Prerequisites

  • Valid Bearer token with person creation permissions
  • Person data meeting required field validation rules

Considerations

  • Unique Communications: Email addresses can only belong to ONE person/entity across entire platform
  • Address Exclusivity: Each address record links to only one person, organisation, or business entity
  • Tax Security: Tax File Numbers encrypted in storage, returned in masked format (***456789)
  • Compliance Triggers: PEP status and sophisticated investor classification require ongoing monitoring
  • Deletion Restrictions: Can only delete persons with no active business relationships

Description

Creates a new person record in the 7G platform. Person records are fundamental building blocks representing individuals who participate in investment structures - including investors, trustees, beneficiaries, directors, and signatories. The created person can be linked to BizEntity records through BizEntityParty relationships.

Advanced Resource: Person records can be created independently via this endpoint or automatically as part of BizEntity operations. Use this endpoint for bulk imports, pre-creating person records for later association, or managing cross-entity person relationships.

7G Person Entity Model

According to the 7G API specifications, Person records:

  • Stand Alone: Can exist independently for later linking to business structures
  • Nested Creation: Address and Communication records are created automatically when included
  • Exclusive Relationships: Each Address/Communication can only belong to one Person, BizEntity, or Organisation
  • Deletion Constraints: Can only be deleted if no relationships exist beyond Address/Communication records

⚠️ ExternalPersonId Deduplication Pattern

Within BizEntity Operations: When creating BizEntity records, reusing the same externalPersonId across multiple party relationships prevents duplicate Person records and ensures proper person reference sharing.

Entity-Level Placement: Set person.externalPersonId within PersonDTO objects (not just at the linking level). The first occurrence creates the person; subsequent uses reuse the existing person record.

Example: In BizEntity POST, if two bizEntityParties reference "externalPersonId": "PERSON-001", the system creates ONE person record reused across both relationships - preventing duplicates.

Result: Proper person deduplication maintains data integrity, prevents duplicate records, and ensures accurate relationship mapping across complex entity structures.

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 (1=Mr, 2=Mrs, 3=Ms, 4=Dr, etc.). 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 (1=Mr, 2=Mrs, 3=Ms, 4=Dr, etc.). 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

json
{
  "personID": 0,
  "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": "123456789",
  "taxationCountryTIN2": "US123456789",
  "taxationCountryTIN3": null,
  "taxationCountryNoTINReason": null,
  "taxationCountryNoTINReason2": null,
  "taxationCountryNoTINReason3": null,
  "taxationFileNumber": "123456789",
  "tradingName": "Smith Consulting",
  "taxOfficeTypeID": 1,
  "tin": "US123456789",
  "titleID": 1,
  "addresses": [
    {
      "addressID": 0,
      "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": 0,
      "bizEntityID": 0,
      "organisationID": 0
    }
  ],
  "communications": [
    {
      "communicationID": 0,
      "externalCommunicationId": null,
      "communicationTypeID": 1,
      "name": "0412345678",
      "bizEntityID": 0,
      "externalBizEntityId": null,
      "personID": 0,
      "externalPersonId": "EXT-PERSON-001",
      "organisationID": 0,
      "externalOrganisationId": null
    },
    {
      "communicationID": 0,
      "externalCommunicationId": null,
      "communicationTypeID": 2,
      "name": "john.smith@example.com",
      "bizEntityID": 0,
      "externalBizEntityId": null,
      "personID": 0,
      "externalPersonId": "EXT-PERSON-001",
      "organisationID": 0,
      "externalOrganisationId": null
    }
  ]
}

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 DELETE Delete Person POST Create Address POST Create Communication