Skip to content

Commit 68cffa4

Browse files
Claire edits and updates
1 parent d7459c0 commit 68cffa4

File tree

1 file changed

+29
-34
lines changed

1 file changed

+29
-34
lines changed

src/content/docs/machine-to-machine-applications/about-m2m/m2m-quick-start-guide.mdx

Lines changed: 29 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
page_id: 4cb63554-d6b3-45cf-bdad-2fac4790d3aa
3-
title: Quick start
3+
title: M2M quick start
44
sidebar:
55
order: 2
66
relatedArticles:
@@ -11,55 +11,50 @@ relatedArticles:
1111

1212
This guide shows you how to create a Machine-to-Machine (M2M) application in Kinde, authorize it for an API, and use the client credentials flow to get a token and make a secure API request.
1313

14-
## Step 1 - Create a machine-to-machine app
14+
## Step 1: Create a machine-to-machine app
1515

16-
1. Go to the **Settings** > **Applications** section in your Kinde dashboard
17-
2. Select **Add application**
18-
3. Enter a name
19-
4. Choose **Machine-to-machine (M2M)**
20-
5. Select **Save**
16+
1. On the Kinde home page, select **Add application**.
17+
2. Enter a name for the application.
18+
3. Choose **Machine-to-machine (M2M)**.
19+
4. Select **Save**.
2120

22-
## Step 2 - Create an API in Kinde (if you don't have one)
21+
## Step 2: Create an API in Kinde (if you don't have one)
2322

2423
You can skip this step if you already have an API registered in Kinde.
2524

26-
1. Go to the **APIs** section in your Kinde dashboard
27-
2. Select **Add API**
28-
3. Enter a name
29-
4. Select **Save**
25+
1. Go to **Settings > APIs**.
26+
2. Select **Add API**.
27+
3. Enter a name for the API.
28+
4. Select **Save**.
3029

31-
For more detail, see [Register and manage APIs](/developer-tools/your-apis/register-manage-apis/).
30+
For details on the full API setup, see [Register and manage APIs](/developer-tools/your-apis/register-manage-apis/).
3231

33-
## Step 3 - Authorize the app to access an API
34-
35-
1. Open your newly created app
36-
2. Go to the **APIs** tab
37-
3. Select the API (audience) this app should be allowed to call.
38-
4. Select **Save**.
32+
## Step 3: Authorize the app to access an API
3933

4034
If you skip this step, token requests will be rejected.
4135

42-
## Step 4 - (Optional) Add scopes
43-
44-
If your API uses scopes to define permissions:
36+
1. Open the newly created M2M app.
37+
2. Go to **APIs** in the menu.
38+
3. Find the API you want to authorize in the list.
39+
4. Select the three dots on the far right and select **Authorize**.
4540

46-
1. Go to **APIs** in your Kinde dashboard
47-
2. Choose the API you’re protecting
48-
3. Add scopes (e.g. `read:users`, `write:flags`)
49-
4. Go back to your M2M app and assign those scopes
41+
## Step 4: (Optional) Add scopes to define permissions
5042

51-
For more detail, see [Define and manage API scopes](/developer-tools/your-apis/api-scopes-m2m-applications/).
43+
1. Go to **Settings > APIs**.
44+
2. Choose the API you want to protect.
45+
3. Select **Scopes** in the menu and add scopes (e.g. `read:users`, `write:flags`).
46+
4. Once you are finished, open the M2M app and assign the scopes. See [Define and manage API scopes](/developer-tools/your-apis/api-scopes-m2m-applications/).
5247

53-
## Step 5 - Get a token
48+
## Step 5: Get a token to test your M2M app
5449

5550
You can test the app in one of two ways:
5651

57-
### Option A - Use the Test tab in Kinde
52+
### Option A - Use the **Test** details in Kinde
5853

59-
1. Open your M2M app
60-
2. Go to the **Test** tab
61-
3. Select the API (audience)
62-
4. Copy the generated token
54+
1. Open your M2M app.
55+
2. Go to **Test** in the menu.
56+
3. Select the API (audience).
57+
4. Copy the generated token.
6358

6459
### Option B - Use the client credentials flow directly
6560

@@ -83,7 +78,7 @@ The response will include a bearer token you can use in requests:
8378
}
8479
```
8580

86-
## Step 6 - Use the token in an API call
81+
## Step 6: Use the token in an API call
8782

8883
Include the token in the `Authorization` header:
8984

0 commit comments

Comments
 (0)