Product ToursProduct Tours

API Integration Tour

A developer-focused tour that walks technical users through the process of connecting to your API, generating keys, making a first request, and verifying the response. This template bridges the gap between documentation and hands-on implementation.

When to Use This Template

Show this tour when a user navigates to the API settings, developer console, or integrations page for the first time. It is also useful after a developer signs up specifically to use your API and lands on the getting-started page.

Template Breakdown

1

Introduction to the API

Display a modal that briefly explains what your API enables, links to the full documentation, and outlines the three steps to get connected: generate a key, make a request, verify the response.

2

Generate an API key

Highlight the "Create API Key" button, explain the difference between test and production keys if applicable, and prompt the user to generate their first key.

3

Copy the key securely

Once the key is generated, highlight the copy button and warn the user that the key will not be shown again. Suggest storing it in an environment variable rather than hardcoding it.

4

Show a sample request

Display a code snippet (cURL or SDK) pre-filled with the user's new API key and a simple endpoint. Explain what each part of the request does โ€” method, headers, body.

5

Verify the response

Point to the API logs or response panel and explain how to confirm that the request succeeded. Highlight common error codes and what they mean for quick troubleshooting.

6

Next steps and resources

Link to the full API reference, SDKs in different languages, and a Postman collection. Suggest a more advanced endpoint to try next to keep the developer engaged.

Best Practices

  • Pre-fill code examples with the user's actual API key and workspace ID to minimize copy-paste friction.
  • Provide examples in multiple languages (cURL, Python, JavaScript, Ruby) based on detected preferences.
  • Include a "Test in sandbox" option so developers can experiment without affecting production data.
  • Link every step to the relevant section of your API documentation for users who want more detail.
  • Track the time from API key generation to first successful request as a key activation metric.

Use This Template

Sign up for Produktly and use this template to get started in minutes.

Start free trial

Related Templates