canva-common-errors

# Canva Common Errors ## Overview Quick reference for the most common Canva Connect API errors at `api.canva.com/rest/v1/*` with real HTTP status codes, error payloads, and fixes. ## Error Reference ### 401 Unauthorized — Token Expired or Invalid ```json { "error": "invalid_token", "message": "The access token is invalid or expired" } ``` **Cause:** Access tokens expire after ~4 hours. Token may be malformed or revoked. **Fix:** ```typescript // Refresh the token const res = await fetch('https://api.canva.com/rest/v1/oauth/token', { method: 'POST', headers: { 'Authorization': `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`, 'Content-Type': 'application/x-www-form-urlencoded', }, body: new URLSearchParams({ grant_type: 'refresh_token', refresh_token: storedRefreshToken, }), }); const { access_token, refresh_token } = await res.json(); // IMPORTANT: Each refresh token is single-use — store the new one ``` --- ### 403 Forbidden — Missing Scope or Insufficient Permissions ```json { "error": "insufficient_scope", "message": "Required scope: design:content:write" } ``` **Cause:** Your integration doesn't have the required OAuth scope enabled, or the user isn't authorized for the resource. **Fix:** 1. Check required scope in the [Scopes Reference](https://www.canva.dev/docs/connect/appendix/scopes/) 2. Enable the scope in your integration settings at [canva.dev](https://www.canva.dev) 3. Re-authorize the user — existing ...