How to Integrate Lovable with Pinterest Ads

Navigate to developers.pinterest.com and sign in with your Pinterest account. Click 'Connect app'. Fill in the app name, description, and redirect URI. Set your redirect URI to your deployed Lovable app URL followed by /auth/pinterest/callback. After creating the app, you will see a Client ID and App Secret. Under 'Permissions', request the ads_read and ads_write scopes. Pinterest's Marketing API requires separate approval — look for the 'Apply for Pinterest Marketing Partners' or 'Request API Access' option in the app settings. Pinterest reviews these requests and may require evidence of an active advertising account. Once approved, generate an access token by directing users to Pinterest's OAuth authorization URL: https://www.pinterest.com/oauth/?client_id={CLIENT_ID}&redirect_uri={REDIRECT_URI}&response_type=code&scope=ads:read,ads:write&state=random_string After authorization, exchange the code for a token at https://api.pinterest.com/v5/oauth/token. Pinterest access tokens have a defined expiry (typically 30 days) and include a refresh token. Your ad account ID is required for all Marketing API calls. Find it in Pinterest Ads Manager — it is the numeric string in the URL when viewing your campaigns.

Open your Lovable project and navigate to Cloud → Secrets via the '+' icon next to Preview. Add the following secrets: - Name: PINTEREST_ACCESS_TOKEN — Value: your OAuth2 access token - Name: PINTEREST_REFRESH_TOKEN — Value: your OAuth2 refresh token - Name: PINTEREST_CLIENT_ID — Value: your Pinterest application Client ID - Name: PINTEREST_CLIENT_SECRET — Value: your Pinterest application App Secret - Name: PINTEREST_AD_ACCOUNT_ID — Value: your numeric Pinterest ad account ID The access token authorizes advertising spend management. The client credentials and refresh token enable automatic renewal. The ad account ID scopes all API calls to your specific advertising account. Never paste Pinterest advertising credentials in Lovable's chat. Lovable's security system blocks approximately 1,200 hardcoded API keys per day, but credentials that control advertising spend deserve extra caution.

Create a Supabase Edge Function that proxies Pinterest Marketing API v5 calls. Pinterest's API base URL is https://api.pinterest.com/v5/ and all requests use Authorization: Bearer {token}. The function handles four core actions: campaigns (list campaigns for the ad account), ad_groups (list ad groups with targeting details), analytics (fetch campaign or ad-level performance metrics), and catalog (retrieve catalog feed status and product counts). Pinterest's v5 analytics endpoint is different from v3 — it requires a POST body rather than query parameters for metric selection. The function handles both GET requests (campaigns, ad_groups) and POST requests (analytics) correctly.

1// supabase/functions/pinterest-ads/index.ts
2const PINTEREST_BASE = 'https://api.pinterest.com/v5';
3
4Deno.serve(async (req) => {
5  if (req.method === 'OPTIONS') {
6    return new Response(null, {
7      headers: {
8        'Access-Control-Allow-Origin': '*',
9        'Access-Control-Allow-Methods': 'POST, OPTIONS',
10        'Access-Control-Allow-Headers': 'Content-Type, Authorization',
11      },
12    });
13  }
14
15  const accessToken = Deno.env.get('PINTEREST_ACCESS_TOKEN');
16  const adAccountId = Deno.env.get('PINTEREST_AD_ACCOUNT_ID');
17
18  if (!accessToken || !adAccountId) {
19    return new Response(JSON.stringify({ error: 'Pinterest credentials not configured' }), {
20      status: 500,
21      headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' },
22    });
23  }
24
25  const headers = { 'Authorization': `Bearer ${accessToken}`, 'Content-Type': 'application/json' };
26  const { action, params } = await req.json();
27
28  let url: string;
29  let fetchOptions: RequestInit;
30
31  if (action === 'campaigns') {
32    url = `${PINTEREST_BASE}/ad_accounts/${adAccountId}/campaigns?entity_statuses=ACTIVE,PAUSED,ARCHIVED&page_size=100`;
33    fetchOptions = { method: 'GET', headers };
34  } else if (action === 'ad_groups') {
35    url = `${PINTEREST_BASE}/ad_accounts/${adAccountId}/ad_groups?campaign_id=${params.campaign_id}&page_size=100`;
36    fetchOptions = { method: 'GET', headers };
37  } else if (action === 'analytics') {
38    const q = new URLSearchParams({
39      start_date: params.start_date,
40      end_date: params.end_date,
41      columns: (params.metrics || ['SPEND_IN_DOLLAR', 'IMPRESSION_1', 'CLICKTHROUGH_1', 'SAVE', 'TOTAL_CONVERSIONS']).join(','),
42      granularity: params.granularity || 'DAY',
43    });
44    if (params.campaign_ids) q.set('campaign_ids', params.campaign_ids.join(','));
45    url = `${PINTEREST_BASE}/ad_accounts/${adAccountId}/analytics?${q}`;
46    fetchOptions = { method: 'GET', headers };
47  } else if (action === 'update_campaign') {
48    url = `${PINTEREST_BASE}/ad_accounts/${adAccountId}/campaigns`;
49    fetchOptions = { method: 'PATCH', headers, body: JSON.stringify([{ id: params.campaign_id, ...params.updates }]) };
50  } else {
51    return new Response(JSON.stringify({ error: 'Invalid action' }), {
52      status: 400,
53      headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' },
54    });
55  }
56
57  const response = await fetch(url, fetchOptions);
58  const data = await response.json();
59
60  return new Response(JSON.stringify(data), {
61    status: response.ok ? 200 : response.status,
62    headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' },
63  });
64});

Use Lovable's chat to build the Pinterest campaign performance dashboard. Pinterest advertising has a unique metric set that reflects the platform's save-and-return behavior: IMPRESSION_1 (impressions), CLICKTHROUGH_1 (link clicks), SAVE (pin saves — users saving your pin to their boards), SAVE_RATE (saves divided by impressions), VIDEO_V_50_WATCH_TIME (for video pins), and TOTAL_CONVERSIONS for purchase tracking. The save rate is a Pinterest-specific KPI worth highlighting prominently in your dashboard — a high save rate indicates content resonates with users who will return to it later, creating long-tail value beyond the initial impression. Build a metric card that shows save rate alongside CTR to give advertisers a complete picture of creative performance. For shopping catalog campaigns, add a catalog performance section that shows top-performing products by ROAS and revenue. Pinterest's Shopping Ads show individual product pins from the catalog, so ad-level performance maps directly to product performance. For the campaign management features, add a budget optimizer view that shows campaigns sorted by ROAS — highest performing campaigns at the top with a budget increase button. This surfaces actionable opportunities to reallocate budget toward the best-performing campaigns without requiring access to Pinterest Ads Manager.