Tedee API documentation

Overview

  • Getting started
  • API versioning
  • API rate limit
  • Logo guideliness
  • Release notes

How to ...

  • Begin integration
  • Authenticate
  • Get and sync locks
  • Operate locks
  • Update lock settings
  • Share device
  • Manage lock PIN list
  • Manage access links
    • Organization access links
    • When you should use access links?
    • When you should not use access links?
    • Create an access link
    • Update an access link
    • Delete an access link
  • Manage and operate gates
  • Use state from door sensor
  • Connect to device via Bluetooth
  • Example integrations

Endpoints

  • DateTime
  • Device
  • Device activity
  • Devices certificate
  • Device access
  • Door sensor
  • Gate
  • Lock
  • Lock PIN
  • Mobile
  • Organization
  • Organization Access Links
  • Personal access key

Webhooks

  • Overview
  • Device battery level changed
  • Device connection changed
  • Device settings changed
  • Lock status changed
  • Bell button pressed

Data structures

  • Access details
  • Bridge
  • Certificate for mobile
  • Device activities
  • Device access
  • Device operation
  • Device settings
  • Device access success
  • Device updated
  • Door sensor list
  • Door sensor state
  • Door sensor user settings
  • Door sensor
  • Execute command response
  • Gate list
  • Gate user settings
  • Gate
  • Location
  • Lock
  • Lock accessory
  • Lock PIN
  • Lock PIN created
  • Lock PIN details
  • Lock PIN list
  • Lock state
  • Lock sync
  • Lock user settings
  • Mobile identifier
  • Mobile registered
  • Organization
  • Organization access link
  • Organization access link created
  • Organization access link list
  • Organization access link single
  • Organization access link device
  • Organization access link assignable device list
  • Organization access link assignable device
  • Personal access key
  • Personal access key created
  • Repeat event
  • Revoked certificate
  • Revoked certificate list
  • Signed time
  • Software versions

Enums

  • Access level
  • Activity source
  • Auto unlock pull condition
  • Device operation type
  • Device type
  • Door state
  • Event type
  • Gate icon
  • Lock state
  • Operating System type
  • Software type
  • Unlock mode
  • Week days
Tedee API documentation
  • How to manage access links
  • View page source

How to manage access links

In this tutorial, we will go through organization access link management. We will show you how to create, update, and delete access links.

We will introduce you to organization access links and how to use them.

Organization access links

Organization access links allows sharing access to Tedee Lock or Gate with a guest by simple Url. A guest with an access link can open locks or gates without having a Tedee account.

Access link can be created only from organization and only for devices which are assigned to organization. If you don’t have an organization, you can create it using Tedee Portal.

Warning

Be careful with who you share the access link with. Anyone with the link can open the Tedee smart lock or gate.

When you should use access links?

Let’s imagine you have a Tedee smart lock installed in your doors and want to give access to your home to your friend. You can create an access link and share it with your friend. Your friend will be able to open the door using the access link. Your friend does not need a Tedee app or a Tedee account.

Another scenario is more business. You have a rental apartment with a Tedee smart lock installed. Your guests want to avoid installing the Tedee app and creating an account. Instead, you can create an access link and share it with your guests. Your guests can open the door using the access link from a web browser.

Your access links will be valid only in the time period you set.

When you should not use access links?

Access links are not a replacement for the Tedee app. If you have family members or employees who always use the Tedee smart lock, they should use the Tedee app. It is more secure and convenient.

Create an access link

You can create an access link from the Tedee Portal. Hovewer, this tutorial will show you how to create an access link using the Tedee API.

Firstly, you need to find an organization you want to create the access link in.

Use Get organization endpoint:

GET https://api.tedee.com/api/v1.36/organization

As a result you will get a list of organizations you administer. You can find the organization you want to create the access link in.

To create an access link, you need to send a POST request using Create organization access link endpoint:

POST https://api.tedee.com/api/v1.36/organization/{organizationId}/accesslink

Where {organizationId} is the ID of the organization you want to create the access link in.

The request body should contain the following parameters:

  • name - the name of the access link. It is a string with a maximum length of 450 characters.

  • description - the description of the access link. It is a string with a maximum length of 72 characters.

  • deviceIds - the list of device IDs you want to assign to the access link. It is a list of integers.

  • repeatEvent - the access details of the access link int UTC.

The example request body is:

{
    "name": "test link for friend",
    "description": "test link to open the door",
    "deviceIds": [
        123,
        223
    ],
    "repeatEvent": {
        "startDate": "2023-01-01T00:00:00.000Z",
        "endDate": "2023-02-01T00:00:00.000Z"
    }
}

Note

Dates sent to Tedee API must be in the UTC timezone. The client must convert the date to UTC before sending it to the API.

After you send the POST request, you will receive the access link id and the access link URL.

{
    "id": "647afced-54af-40bf-90b9-f8ef28946088",
    "url": "https://portal.tedee.com/link/10df36b5-a06e-4bec-9398-786b0231453a"
}

Received access link URL you can share with your friends or guests. They can open the Tedee smart lock or gate using the access link URL.

Note

Tedee smart locks or gate activities will contains unlocks triggered from the access link. You can check them using both the Tedee mobile app and the Tedee Portal.

Update an access link

You can always update the access link. You can change the name, description, devices assigned to the access link, and the time period the access link is valid.

To update an access link, you need to send a PATCH request using Update organization access link endpoint:

PATCH https://api.tedee.com/api/v1.36/organization/{organizationId}/accesslink/{accessLinkId}

Where {organizationId} is the ID of the organization you want to update the access link in and {accessLinkId} is the ID of the access link you want to update.

Delete an access link

You can delete an access link. After you delete the access link, it will not be valid anymore.

To delete an access link, you need to send a DELETE request using Delete organization access link endpoint:

DELETE https://api.tedee.com/api/v1.36/organization/{organizationId}/accesslink/{accessLinkId}

Where {organizationId} is the ID of the organization you want to delete the access link in and {accessLinkId} is the ID of the access link you want to delete.

Warning

After you delete the access link, it will not be valid anymore. You can not restore it.

Previous Next

© Copyright 2023, Tedee.

Built with Sphinx using a theme provided by Read the Docs.