Create User

Status Changelog Dashboard Create a Ticket
Search…
Create User
Please note that both POST and PATCH calls on the user document perform various asynchronous operations. So it's not recommended to make subsequent POST and then PATCH requests on the same user document as that can lead to various race conditions. We recommend submitting all documents at once vs performing subsequent operations on the same document.
post
https://api.synapsefi.com
/v3.1/users
User
Go to User Object Details to see all the required and optional body parameters allowed during user creation. 
Example Request
HTTP
cURL
Python
JS
PHP
GO
1
POST /v3.1/users HTTP/1.1
2
Host: https://uat-api.synapsefi.com
3
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
4
X-SP-USER-IP: 255.127.79.76
5
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
6
Content-Type: application/json
7
​
8
 {
9
  "logins": [
10
    {
11
      "email": "[email protected]",
12
      "password":"TestTest123quot;
13
    }
14
  ],
15
  "phone_numbers": [
16
    "901.111.1111"
17
  ],
18
  "legal_names": [
19
    "Test User"
20
  ],
21
  "documents":[{
22
        "email":"[email protected]",
23
        "phone_number":"901.111.1111",
24
        "ip":"::1",
25
        "name":"Test User",
26
        "alias":"Test",
27
        "entity_type":"M",
28
        "entity_scope":"Arts & Entertainment",
29
        "day":2,
30
        "month":5,
31
        "year":1989,
32
        "address_street":"1 Market St.",
33
        "address_city":"SF",
34
        "address_subdivision":"CA",
35
        "address_postal_code":"94105",
36
        "address_country_code":"US",
37
        "virtual_docs":[{
38
            "document_value":"2222",
39
            "document_type":"TIN",
40
            "meta":{
41
                "country_code":"US"
42
            }
43
        }],
44
        "physical_docs":[{
45
            "document_value": "data:image/gif;base64,SUQs==",
46
            "document_type": "GOVT_ID",
47
            "meta":{
48
                "country_code":"US",
49
                "state_code":"CA"
50
            }
51
        },
52
        {
53
            "document_value": "data:image/gif;base64,SUQs==",
54
            "document_type": "GOVT_ID_BACK",
55
            "meta":{
56
                "country_code":"US",
57
                "state_code":"CA"
58
            }
59
        }],
60
        "social_docs":[{
61
            "document_value": "101 2nd St. STE 1500 SF CA US 94105",
62
            "document_type": "MAILING_ADDRESS",
63
            "meta":{
64
                "address_street":"101 2nd St STE 1500",
65
                "address_city":"SF",
66
                "address_subdivision":"CA",
67
                "address_postal_code":"94105",
68
                "address_country_code":"US",
69
                "address_care_of":"Some User"
70
            }
71
        }]
72
    }],
73
  "extra": {
74
    "supp_id": "122eddfgbeafrfvbbb",
75
    "cip_tag":1,
76
    "is_business": false
77
  }
78
}
Copied!
1
curl --location --request POST 'https://uat-api.synapsefi.com/v3.1/users' \
2
--header 'X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW' \
3
--header 'X-SP-USER-IP: 255.127.79.76' \
4
--header 'X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
5
--header 'Content-Type: application/json' \
6
--data-raw ' {
7
  "logins": [
8
    {
9
      "email": "[email protected]",
10
      "password":"TestTest123quot;
11
    }
12
  ],
13
  "phone_numbers": [
14
    "901.111.1111"
15
  ],
16
  "legal_names": [
17
    "Test User"
18
  ],
19
  "documents":[{
20
        "email":"[email protected]",
21
        "phone_number":"901.111.1111",
22
        "ip":"::1",
23
        "name":"Test User",
24
        "alias":"Test",
25
        "entity_type":"M",
26
        "entity_scope":"Arts & Entertainment",
27
        "day":2,
28
        "month":5,
29
        "year":1989,
30
        "address_street":"1 Market St.",
31
        "address_city":"SF",
32
        "address_subdivision":"CA",
33
        "address_postal_code":"94105",
34
        "address_country_code":"US",
35
        "virtual_docs":[{
36
            "document_value":"2222",
37
            "document_type":"TIN",
38
            "meta":{
39
                "country_code":"US"
40
            }
41
        }],
42
        "physical_docs":[{
43
            "document_value": "data:image/gif;base64,SUQs==",
44
            "document_type": "GOVT_ID",
45
            "meta":{
46
                "country_code":"US",
47
                "state_code":"CA"
48
            }
49
        },
50
        {
51
            "document_value": "data:image/gif;base64,SUQs==",
52
            "document_type": "GOVT_ID_BACK",
53
            "meta":{
54
                "country_code":"US",
55
                "state_code":"CA"
56
            }
57
        }],
58
        "social_docs":[{
59
            "document_value": "101 2nd St. STE 1500 SF CA US 94105",
60
            "document_type": "MAILING_ADDRESS",
61
            "meta":{
62
                "address_street":"101 2nd St STE 1500",
63
                "address_city":"SF",
64
                "address_subdivision":"CA",
65
                "address_postal_code":"94105",
66
                "address_country_code":"US",
67
                "address_care_of":"Some User"
68
            }
69
        }]
70
    }],
71
  "extra": {
72
    "supp_id": "122eddfgbeafrfvbbb",
73
    "cip_tag":1,
74
    "is_business": false
75
  }
76
}'
Copied!
1
​
Copied!
1
​
Copied!
1
​
Copied!
1
​
Copied!
Verifying Addresses
We validate addresses to ensure an address is mailable. Prior to submitting an address, we encourage you to Verify Address. We also recommend that you use Google Maps, the USPS ZIP Code Lookup Tool or similar tools to autocomplete addresses prior to verifying. This should reduce the risk of submitting improperly formatted addresses.
View User
Update User
Last modified 8mo ago
Export as PDF
Copy link
Contents
post
User
Example Request