Invites

Email or text users a URL connecting them to Link.

  1. Adjust the invite text or branding through Invite settings in Console.
  2. Send invites to users via email, SMS, or both.
  3. Re-send an invite if a user needs to return to Link, or lost their original invite.

#Send an invite

post/v2/invites
  • Immediately sends an invite via email, SMS, or both.
  • Returns an invite object in the response.
Request body
  • #
    full_namestring
    required

    Name of the invite recipient.

  • #
    phone_numberstring
    optional

    Phone number of the invite recipient.

    *Required when email is empty.

  • #
    emailstring
    optional

    Email address of the invite recipient.

    *Required when phone_number is empty.

  • #
    external_idstring
    optional

    External identifier often used to group users. Will populate the external_id property of the user object, and can be used to search for users within the Connections section of Console.

  • #
    flow_idstring
    optional

    ID used to customize the user's experience in Link.

    Must be the ID of an Email/SMS Template.


  • #
    flow_itemsarray of strings
    optional

    List of specific Items to display to the invite recipient. Instead of full search, direct login will be used (one Item) or list (multiple Items).

    flow_items will override direct login Items associated with the flow_id.

  • #
    dds_configobject
    optional

    Unencrypted target deposit destination. Adds a deposit switching flow after the user connects their payroll accounts.

  • #
    override_invite_templateobject
    optional

    Overrides the text and branding of the email/SMS template specified via the flow_id property (or default invite settings, if no templates exist).

    Also provides a way to Cc members of your team to be notified by email when the user has connected their payroll account(s) by using the reply_to parameter.

The invite object
  • #
    idstring (uuid)

    Unique ID of the invite.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_tokenstring

    User token required to initialize embedded instances of Link for the user.

    This user token will expire after one hour. A new user token can be created at any time using the /user-tokens API endpoint.

  • #
    emailstring

    Email of the invite recipient.

  • #
    phone_numberstring

    Phone number of the invite recipient.

  • #
    full_namestring

    Name of the invite recipient.

  • #
    revoked_atstring (datetime)

    Timestamp (ISO 8601) when the invite was revoked.

  • #
    statusstring (enum)

    The invite's status.

  • #
    group_idstring (uuid)

    ID of the group associated with the invite.

  • #
    urlstring

    URL included in the invite that connects the user to Link.

  • #
    created_atstring (datetime)

    Timestamp (ISO 8601) when the invite was created.

  • #
    updated_atstring (datetime)

    Timestamp (ISO 8601) when the invite was updated.

    The timestamp is updated after re-sending or revoking an invite.

  • #
    invited_atstring (datetime)

    Timestamp (ISO 8601) when the invite was sent.

    The timestamp is updated after re-sending or revoking an invite.

  • #
    flow_idstring

    ID of the Flow specified via the flow_id parameter when sending the invite.

  • #
    flow_itemsarray of strings

    Any Items specified via the flow_items parameter when sending the invite.

  • #
    reply_toarray of strings

    Emails of your team members that will be notified when the user has connected their payroll account(s).

  • #
    (Deprecated) invite_template_idstring (uuid)

    Customization ID.
    — Deprecated in favor of override_invite_template.

Example Request
1curl --request POST \
2     --url https://api.argyle.com/v2/invites \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "full_name": "Sarah Longfield",
7        "phone_number": "212-555-5555",
8        "email": "[email protected]"
9     }'
Example Response
1{
2  "id": "0424137bc-edc5-35de-c1b5-1c3cddb4b227",
3  "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
4  "user_token": "bcJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWEiOiIxNDRhMTRkNS04YzEzLTQzZGYtOTI4Ni01OWY4NjFkOWEyMDIiLCJleHAiOjE2ODc3OTMzODAsImZpZCI6IjUyYWM3ZFFiLTI1MzAtNGYyNy04NTZlLTkwOTk1ZDA4NWJkMCIsImlhdCI6MTY4Nzc4OTc4MCwiaXNzIjoiYXJneWxlLWNvcmUtYXV1aC1kZXYiLCJqdGki2eJiZGI4YTExMS0wYzFjLTRiNjEtYmI5NS04ZGQ0YzA0OGQwNzUiLCJzdWIiOiIwMTg4ZjgxYy0zZTFkLTRlZDEtMjEyYy02NmB3YzE4YzVjYzMiLCJ1c2VyX2lkIjoiMDE4OGY4MWMtM2UxZC00ZWQxLTIxMmMtNjZhN2MxN2M1Y2MzIn0.TNiZojOiiXtPVamyCDjz4f2GwR4TA8x6JR3RwjTECjY",
5  "email": "[email protected]",
6  "phone_number": "212-555-5555",
7  "full_name": "Sarah Longfield",
8  "revoked_at": null,
9  "status": "sent",
10  "group_id": "d8a07e5b-13a3-11ef-af7e-c7eb00762562",
11  "url": "https://console.argyle.com/add-work-accounts/0424137bc-edc5-35de-c1b5-1c3cddb4b227",
12  "created_at": "2023-03-09T23:57:05.756Z",
13  "updated_at": "2023-03-09T23:57:05.756Z",
14  "invited_at": "2023-03-09T23:57:05.756Z",
15  "flow_id": "8DRRA4XC",
16  "flow_items": [
17    "item_000000001",
18    "item_000000002"
19  ],
20  "reply_to": [
21    "[email protected]",
22    "[email protected]"
23  ],
24  "invite_template_id": null
25}

#Retrieve an invite

get/v2/invites/{id}

Retrieves an invite object.

Path parameters
  • #
    idstring (uuid)
    required

    ID of the invite to be retrieved.

Example Request
1curl --request GET \
2     --url https://api.argyle.com/v2/invites/{id} \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1{
2  "id": "0424137bc-edc5-35de-c1b5-1c3cddb4b227",
3  "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
4  "user_token": "bcJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWEiOiIxNDRhMTRkNS04YzEzLTQzZGYtOTI4Ni01OWY4NjFkOWEyMDIiLCJleHAiOjE2ODc3OTMzODAsImZpZCI6IjUyYWM3ZFFiLTI1MzAtNGYyNy04NTZlLTkwOTk1ZDA4NWJkMCIsImlhdCI6MTY4Nzc4OTc4MCwiaXNzIjoiYXJneWxlLWNvcmUtYXV1aC1kZXYiLCJqdGki2eJiZGI4YTExMS0wYzFjLTRiNjEtYmI5NS04ZGQ0YzA0OGQwNzUiLCJzdWIiOiIwMTg4ZjgxYy0zZTFkLTRlZDEtMjEyYy02NmB3YzE4YzVjYzMiLCJ1c2VyX2lkIjoiMDE4OGY4MWMtM2UxZC00ZWQxLTIxMmMtNjZhN2MxN2M1Y2MzIn0.TNiZojOiiXtPVamyCDjz4f2GwR4TA8x6JR3RwjTECjY",
5  "email": "[email protected]",
6  "phone_number": "212-555-5555",
7  "full_name": "Sarah Longfield",
8  "revoked_at": null,
9  "status": "sent",
10  "group_id": "d8a07e5b-13a3-11ef-af7e-c7eb00762562",
11  "url": "https://console.argyle.com/add-work-accounts/0424137bc-edc5-35de-c1b5-1c3cddb4b227",
12  "created_at": "2023-03-09T23:57:05.756Z",
13  "updated_at": "2023-03-09T23:57:05.756Z",
14  "invited_at": "2023-03-09T23:57:05.756Z",
15  "flow_id": "8DRRA4XC",
16  "flow_items": [
17    "item_000000001",
18    "item_000000002"
19  ],
20  "reply_to": [
21    "[email protected]",
22    "[email protected]"
23  ],
24  "invite_template_id": null
25}

#Re-send an invite

post/v2/invites/{id}

Re-sends a previously sent invite. Updates the updated_at and invited_at time.

Path parameters
  • #
    idstring (uuid)
    required

    ID of the invite to be re-sent.

Example Request
1curl --request POST \
2     --url https://api.argyle.com/v2/invites/{id} \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1{
2  "id": "0424137bc-edc5-35de-c1b5-1c3cddb4b227",
3  "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
4  "user_token": "bcJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWEiOiIxNDRhMTRkNS04YzEzLTQzZGYtOTI4Ni01OWY4NjFkOWEyMDIiLCJleHAiOjE2ODc3OTMzODAsImZpZCI6IjUyYWM3ZFFiLTI1MzAtNGYyNy04NTZlLTkwOTk1ZDA4NWJkMCIsImlhdCI6MTY4Nzc4OTc4MCwiaXNzIjoiYXJneWxlLWNvcmUtYXV1aC1kZXYiLCJqdGki2eJiZGI4YTExMS0wYzFjLTRiNjEtYmI5NS04ZGQ0YzA0OGQwNzUiLCJzdWIiOiIwMTg4ZjgxYy0zZTFkLTRlZDEtMjEyYy02NmB3YzE4YzVjYzMiLCJ1c2VyX2lkIjoiMDE4OGY4MWMtM2UxZC00ZWQxLTIxMmMtNjZhN2MxN2M1Y2MzIn0.TNiZojOiiXtPVamyCDjz4f2GwR4TA8x6JR3RwjTECjY",
5  "email": "[email protected]",
6  "phone_number": "212-555-5555",
7  "full_name": "Sarah Longfield",
8  "revoked_at": null,
9  "status": "sent",
10  "url": "https://console.argyle.com/add-work-accounts/0424137bc-edc5-35de-c1b5-1c3cddb4b227",
11  "created_at": "2023-03-09T23:57:05.756Z",
12  "updated_at": "2023-04-06T05:42:13.278Z",
13  "invited_at": "2023-04-06T05:42:13.278Z",
14  "invite_template_id": null
15}

#Revoke an invite

post/v2/invites/{id}/revoke

Invalidates a previously sent invite.

If a user clicks a revoked invite URL, the landing page will notify the user the invite has expired.

Path parameters
  • #
    idstring (uuid)
    required

    ID of the invite to be revoked.

Example Request
1curl --request POST \
2     --url https://api.argyle.com/v2/invites/{id}/revoke \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1{
2  "id": "0424137bc-edc5-35de-c1b5-1c3cddb4b227",
3  "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
4  "user_token": "bcJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWEiOiIxNDRhMTRkNS04YzEzLTQzZGYtOTI4Ni01OWY4NjFkOWEyMDIiLCJleHAiOjE2ODc3OTMzODAsImZpZCI6IjUyYWM3ZFFiLTI1MzAtNGYyNy04NTZlLTkwOTk1ZDA4NWJkMCIsImlhdCI6MTY4Nzc4OTc4MCwiaXNzIjoiYXJneWxlLWNvcmUtYXV1aC1kZXYiLCJqdGki2eJiZGI4YTExMS0wYzFjLTRiNjEtYmI5NS04ZGQ0YzA0OGQwNzUiLCJzdWIiOiIwMTg4ZjgxYy0zZTFkLTRlZDEtMjEyYy02NmB3YzE4YzVjYzMiLCJ1c2VyX2lkIjoiMDE4OGY4MWMtM2UxZC00ZWQxLTIxMmMtNjZhN2MxN2M1Y2MzIn0.TNiZojOiiXtPVamyCDjz4f2GwR4TA8x6JR3RwjTECjY",
5  "email": "[email protected]",
6  "phone_number": "212-555-5555",
7  "full_name": "Sarah Longfield",
8  "revoked_at": null,
9  "status": "sent",
10  "group_id": "d8a07e5b-13a3-11ef-af7e-c7eb00762562",
11  "url": "https://console.argyle.com/add-work-accounts/0424137bc-edc5-35de-c1b5-1c3cddb4b227",
12  "created_at": "2023-03-09T23:57:05.756Z",
13  "updated_at": "2023-03-09T23:57:05.756Z",
14  "invited_at": "2023-03-09T23:57:05.756Z",
15  "flow_id": "8DRRA4XC",
16  "flow_items": [
17    "item_000000001",
18    "item_000000002"
19  ],
20  "reply_to": [
21    "[email protected]",
22    "[email protected]"
23  ],
24  "invite_template_id": null
25}

#List all invites

get/v2/invites

Returns an object containing all invite objects.

Query parameters
  • #
    statusstring
    optional

    Filter invites by status.

    Multiple status values can be searched at once using either method:

    1. /v2/invites?status=sent,initiated
    2. /v2/invites?status=sent&status=initiated

  • #
    reply_tostring
    optional

    Filter invites for a specific reply_to email.

  • #
    limitinteger
    optional

    Number of invite objects returned per page. Default: 10. Maximum: 200.

Example Request
1curl --request GET \
2     --url https://api.argyle.com/v2/invites?limit=2 \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1[
2  {
3    "id": "0424137bc-edc5-35de-c1b5-1c3cddb4b227",
4    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
5    "user_token": null,
6    "email": "[email protected]",
7    "phone_number": "212-555-5555",
8    "full_name": "Sarah Longfield",
9    "revoked_at": null,
10    "status": "completed",
11    "group_id": "d8a07e5b-13a3-11ef-af7e-c7eb00762562",
12    "url": "https://console.argyle.com/add-work-accounts/0424137bc-edc5-35de-c1b5-1c3cddb4b227",
13    "created_at": "2023-03-09T23:57:05.756Z",
14    "updated_at": "2023-03-09T23:57:05.756Z",
15    "invited_at": "2023-03-09T23:57:05.756Z",
16    "flow_id": "8DRRA4XC",
17    "flow_items": [
18      "item_000000001",
19      "item_000000002"
20    ],
21    "reply_to": [
22      "[email protected]",
23      "[email protected]"
24    ],
25    "invite_template_id": null
26  },
27  {
28    "id": "0186c5b8-8fa1-67b3-39af-14b3e18da8a7",
29    "user": "f3041cb5-bf31-21cb-aa05-df294c161fd9",
30    "user_token": null,
31    "email": "[email protected]",
32    "phone_number": "212-867-5309",
33    "full_name": "Bob Jones",
34    "revoked_at": null,
35    "status": "initiated",
36    "group_id": null,
37    "url": "https://console.argyle.com/add-work-accounts/f3041cb5-bf31-21cb-aa05-df294c161fd9",
38    "created_at": "2023-03-10T01:22:36.432Z",
39    "updated_at": "2023-03-10T01:22:36.432Z",
40    "invited_at": "2023-03-10T01:22:36.432Z",
41    "flow_id": "R23CELUZ",
42    "flow_items": [],
43    "reply_to": [],
44    "invite_template_id": null
45  }
46]
Updating Argyle status...
© 2024 Argyle Systems Inc.argyle.com