Invites are useful for the following scenarios:
- Invite someone to signup to your app or website.
- Invite someone on behalf of one of your user's, e.g. to track and reward when one of your users successfully invites their friends to join your app.
- Custom scenarios, such as securely inviting a user to access a shared document or join a team, are supported using the
invite.extras
property, for example by storing a document or team ID.
{
"id": "invt_LfbrvhnlUAyM1N",
"token_raw": "invt_LfbrvhnlUAyM1N-ReHwpMKWj5NIY0pv3x0NcurW",
"invite_url": "https://api.userkit.io/hosted_widget?app=app_6fa64vtE&invt=invt_LfbrvhnlUAyM1N-ReHwpMKWj5NIY0pv3x0NcurW",
"app_id": "app_6fa64vtE",
"from_user": null,
"accepted": false,
"expires_secs": 604800,
"to_email": "[email protected]",
"created": 1476888188.08038,
"extras": null,
"accepted_user": null,
"accepted_date": null
}
token_raw
andinvite_url
should be handled carefully. Remember, anyone who has access to an invite-url or token can accept the invite.Note: These properties are only present at the time the invite is created. If you fetch an existing invite later on you won't have access to these properties.