Guide: First API Call

A detailed walkthrough for making your first authenticated API call.

Prerequisites

1. An I'mBoard account with at least one board
2. A personal access token (see Authentication)

Step 1: Create a Token

Navigate to Account > API Access in the I'mBoard app and create a new token. Copy it immediately — it won't be shown again.

Step 2: Verify Authentication

curl -s https://app.imboard.ai/api/v1/me \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" | jq

If successful, you'll see your user profile. If you get a 401, double-check the token.

Step 3: List Your Boards

curl -s https://app.imboard.ai/api/v1/boards \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" | jq

Step 4: Explore a Board

Pick a board ID from the response and fetch its details:

curl -s https://app.imboard.ai/api/v1/boards/BOARD_ID \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" | jq

Next Steps

• List Board Meetings
• Create & Update a Meeting
• Claude Code & MCP