createRepresentative

Variables

entity_id

Field Type Description
entity_id UUID The unique identifier for the entity to which the representative is being added.

representative

Field Type Description
document_expiration_date DateTime The expiration date of the representative's identification document.
document_issue_date DateTime The issue date of the representative's identification document.
document_number String The number of the representative's identification document.
citizenship String The country of citizenship of the representative.
date_of_birth DateTime The date of birth of the representative.
email String The email address of the representative.
first_name String The first name of the representative.
is_signer Boolean Indicates if the representative is a signer for the entity.
last_name String The last name of the representative.
job_title String The job title of the representative within the entity.
ownership_percentage Float The percentage of ownership the representative has in the entity.
passport_number String The passport number of the representative, if applicable.
phone String The phone number of the representative.
residential_address String The primary residential address of the representative.
residential_address2 String The secondary residential address of the representative (optional).
residential_city String The city of the representative's residential address.
residential_country String The country of the representative's residential address.
residential_postal_code String The postal code of the representative's residential address.
residential_state_province_region String The state, province, or region of the representative's residential address.
responsibility String The responsibility of the representative within the entity. Can be one of:
- ultimate_beneficial_owner
- authorized rep
- director
tax_number String The tax identification number of the representative e.g. SSN for US citizens.

Query

string

Defaults to {}

Response examples

Success (200)

{
  "data": {
    "createRepresentative": "573442c4-e010-480b-9acf-861fac940e9a"
  }
}

Error (400)

{
  "errors": [
    {
      "message": "Invalid request syntax"
    }
  ]
}

Example Code

const axios = require('axios');

const token = process.env.RF_KEY;

let data = JSON.stringify({
  query: `mutation createRepresentative (
    $entity_id: UUID
    $representative: RepresentativeInput
) {
    createRepresentative (
        entity_id: $entity_id
        representative: $representative
    )
}`,
  variables: {
    entity_id: "YOUR_ENTITY_ID",
    representative: {
      document_expiration_date: '1990-09-26T00:00:00Z',
      document_issue_date: '2020-10-28T00:00:00Z',
      document_number: '9078092879078320978',
      citizenship: "USA",
      date_of_birth: "1990-09-26T00:00:00Z",
      email: 'meow@meow.com',
      first_name: "John",
      is_signer: true,
      last_name: "Smith",
      job_title: "CEO",
      ownership_percentage: 100,
      passport_number: null,
      phone: '2813308004',
      residential_address: '1305 e 6th street',
      residential_address2: null,
      residential_city: "Austin",
      residential_country: "USA",
      residential_postal_code: '78733',
      residential_state_province_region: "TX",
      responsibility: "ultimate_beneficial_owner",
      tax_number: '12123222'
    }
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://sandbox.external.routefusion.com/graphql',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  data: data
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch((error) => {
    console.error(error.response ? error.response.data : error.message);
  });