Skip to main content

How to create and connect an Open API application with Planday

Learn how to connect Planday with other software or online services using our Open API.

Written by Anton E

🔓 Access level in Planday: Administrator with access to all departments

🌐 Subscription plan: Plus, Pro

⏱️ Reading time: 3 min

ℹ️ Important read: If you want to integrate another system with Planday using our Open API, visit OpenAPI.Planday.com. There you'll find technical documentation covering the API's features, best practices and authorisation process.


Connect an existing app using an Application ID

If you're setting up an integration with another system and the provider has given you an Application ID, follow these steps to connect it to Planday.

  1. In Planday web, go to Settings > Integrations > API access.

  2. Click Connect app.

  3. Enter the Application ID provided by the other system and click Save.

  4. The app will now appear in your application list. Click Authorise.

  5. Review the permissions you're granting the app, then click Authorise again to confirm.

Tip: You can copy the app's token directly from its tile on the API access page whenever you need it.


Create your own Planday API app credentials

To create an API application yourself, follow these steps to set up its credentials.

  1. In Planday web, go to Settings > Integrations > API access.

  2. Click Create app.

  3. Enter a name for your application in the title field.

  4. Select the Scopes to define which Planday data the application can access.

  5. Click Save.

New Planday API App Scopes

Your new application will appear in the application list.

Click Authorise and review the selected permissions to confirm.

Your application is now authorised. You can find its credentials on the application tile.

Connect the application to other Planday organisations

If you want to use the same application with several Planday organisations, follow the steps in Connect an app using an Application ID. Use the Application ID of the application you just created.
​


Reauthorise an app after an administrator account is deactivated

If an administrator who authorised an Open API application has their Planday account deactivated, any systems using that application's credentials will lose access to your Planday data. This is a security measure to protect your data.


​To restore access:

  1. In Planday web, go to Settings > API access.

  2. Find the affected application in your application list.

  3. Click Authorise.

  4. Review and confirm the permission scopes.

Planday will generate a new token for the application.

Important: Update the token in every external system that uses this application. Otherwise, those systems won't be able to access your Planday data.


How to get help with the Planday API

If you want to integrate your software or service with Planday using our API and have questions, we're happy to help. Please read this Get started guide on OpenAPI.Planday.com to get familiar with the basics.

If you need to get in touch with us regarding API questions, you can write to our team at APISupport@Planday.com
​
To help us understand your request and assist you more quickly, please use the template below when contacting us. Include as much relevant information as possible.

Important: Don't include passwords, access tokens or other sensitive information in your email. Remove any personal data from your examples before sharing them.

​You can include:

  • Subject: {question topic}

  • App ID: {Your test application's App ID, if available}

  • Planday URL: {Your Planday portal URL, e.g. devdemo.planday.com}

  • API request URL: {The URL of your API request, if relevant}

  • API request body: {The request body, if relevant}

  • API response code: {The response code, if relevant}

  • API response body: {The response body, if relevant}

  • Date and time of API request: {When you made the request, if relevant}

  • Question details: {Describe what you are trying to do and what you need help with. If something isn't working as expected, explain what happened and what you expected to happen instead.}


Read next:


ℹ️ Need more help?

🔍 Search the Help Center | See videos at Tutorials.Planday.com | Watch a webinar

💬 For personalised support

Login and contact our support team via the blue icon at the bottom if you have more questions or book a one-to-one professional training session with an expert.

Tags

These tags help with search and discovery of articles.

openapi PlandayAPI REST API

Did this answer your question?