Guides Use cases
APIs & SDKs
Changelog
  1. Moov.js
  2. Moov accounts

Representatives

Create representative

Moov accounts associated with businesses require information regarding individuals who represent the business. You can provide this information by creating a representative.

Parameters

Name Type
accountID UUID string
representative Representative 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

const accountID = accountID;
const representative = {
    "name": {
        "firstName": "Amanda",
        "middleName": "Amanda",
        "lastName": "Yang",
        "suffix": "Jr"
    },
    "phone": {
        "number": "818.555.1212",
        "countryCode": "1"
    },
    "email": "amanda@classbooker.dev",
    "address": {
        "addressLine1": "123 Main Street",
        "addressLine2": "Apt 302",
        "city": "Boulder",
        "stateOrProvince": "Colorado",
        "postalCode": "80301",
        "country": "US"
    },
    "birthDate": {
        "day": 9,
        "month": 11,
        "year": 1989
    },
    "governmentID": {
        "ssn": {
        "full": "123-45-6789",
        "lastFour": "6789"
        },
        "itin": {
        "full": "123-45-6789",
        "lastFour": "6789"
        }
    },
    "responsibilities": {
        "isController": false,
        "isOwner": true,
        "ownershipPercentage": 38,
        "jobTitle": "CEO"
    }
};
moov.accounts.representatives.create({accountID, representative});

List representatives

A Moov account may have multiple representatives depending on the associated business’s ownership and management structure. You can use this method to list all the representatives for a given Moov account. Note that Moov accounts associated with an individual do not have representatives.

Parameters

Name Type
accountID UUID string 
1

moov.accounts.representatives.list({accountID});

Get representative

Retrieve a specific representative associated with a given Moov account.

Parameters

Name Type
accountID UUID string
representativeID UUID string 
1

moov.accounts.representatives.list({accountID, representativeID});

Delete representative

Deletes a business representative associated with a Moov account.

Parameters

Name Type
accountID UUID string
representativeID UUID string 
1

moov.accounts.representatives.delete({accountID, representativeID});

Update representative

If a representative’s information has changed and you need to update it, you can use this method to change any of the fields associated with that particular representative.

Parameters

Name Type
accountID UUID string
representative Representative 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

const accountID = accountID;
const representative = {
    "name": {
        "firstName": "Amanda",
        "middleName": "Amanda",
        "lastName": "Yang",
        "suffix": "Jr"
    },
    "phone": {
        "number": "818.555.1212",
        "countryCode": "1"
    },
    "email": "amanda@classbooker.dev",
    "address": {
        "addressLine1": "123 Main Street",
        "addressLine2": "Apt 302",
        "city": "Boulder",
        "stateOrProvince": "Colorado",
        "postalCode": "80301",
        "country": "US"
    },
    "birthDate": {
        "day": 9,
        "month": 11,
        "year": 1989
    },
    "governmentID": {
        "ssn": {
        "full": "123-45-6789",
        "lastFour": "6789"
        },
        "itin": {
        "full": "123-45-6789",
        "lastFour": "6789"
        }
    },
    "responsibilities": {
        "isController": false,
        "isOwner": true,
        "ownershipPercentage": 38,
        "jobTitle": "CEO"
    }
};
moov.accounts.representatives.update({accountID, representative});