How to Integrate Sharpspring with V0

Open V0 at v0.dev and describe your marketing form or automation dashboard. For lead capture, specify the exact fields you need, the form layout (single vs multi-step), and the post-submission behavior. For a dashboard, describe the metrics you want to display, the chart types, and the filter options. SharpSpring deals in 'leads' (not contacts), and they have built-in fields like firstName, lastName, emailAddress, phoneNumber, companyName, website, and many custom fields. Design your form fields to map cleanly to these SharpSpring lead fields. Once V0 generates the component, use the Design panel to refine colors and spacing, then push to GitHub via the Git panel for auto-deployment. The form will use placeholder submission logic until you create the API route.

SharpSpring's API uses a unique authentication pattern: each request requires an account ID and a session ID. The session ID is an MD5 hash of your Account ID concatenated with your Secret Key. You must include both accountID and sessionID as query parameters on every request, and the request body uses a JSON-RPC style format with a method name and params object. The API endpoint is https://api.sharpspring.com/pubapi/v1.2/. To create a lead, the method is 'createLeads' and the params is an object with a key 'objects' containing an array of lead objects. The API response wraps the result in a 'result' object. This authentication pattern is unusual but consistent — once you implement the session ID generation correctly, all subsequent API calls follow the same pattern.

1import { NextRequest, NextResponse } from 'next/server';
2import { createHash } from 'crypto';
3
4const SHARPSPRING_API_URL = 'https://api.sharpspring.com/pubapi/v1.2/';
5
6function generateSessionId(accountId: string, secretKey: string): string {
7  return createHash('md5').update(`${accountId}${secretKey}`).digest('hex');
8}
9
10async function callSharpSpringAPI(method: string, params: Record<string, unknown>) {
11  const accountId = process.env.SHARPSPRING_ACCOUNT_ID;
12  const secretKey = process.env.SHARPSPRING_SECRET_KEY;
13
14  if (!accountId || !secretKey) {
15    throw new Error('SharpSpring credentials not configured');
16  }
17
18  const sessionId = generateSessionId(accountId, secretKey);
19  const url = `${SHARPSPRING_API_URL}?accountID=${accountId}&sessionID=${sessionId}`;
20
21  const requestBody = {
22    method,
23    params,
24    id: `req_${Date.now()}`,
25  };
26
27  const response = await fetch(url, {
28    method: 'POST',
29    headers: { 'Content-Type': 'application/json' },
30    body: JSON.stringify(requestBody),
31  });
32
33  if (!response.ok) {
34    throw new Error(`SharpSpring API HTTP error: ${response.status}`);
35  }
36
37  return response.json();
38}
39
40export async function POST(request: NextRequest) {
41  try {
42    const body = await request.json();
43
44    if (!body.emailAddress) {
45      return NextResponse.json({ error: 'emailAddress is required' }, { status: 400 });
46    }
47
48    const leadObject = {
49      emailAddress: body.emailAddress,
50      firstName: body.firstName ?? '',
51      lastName: body.lastName ?? '',
52      phoneNumber: body.phone ?? '',
53      companyName: body.companyName ?? '',
54      website: body.website ?? '',
55      description: body.message ?? '',
56    };
57
58    const result = await callSharpSpringAPI('createLeads', { objects: [leadObject] });
59
60    if (result.error) {
61      return NextResponse.json({ error: result.error.message }, { status: 400 });
62    }
63
64    return NextResponse.json({ success: true, result: result.result });
65  } catch (error) {
66    console.error('SharpSpring API route error:', error);
67    return NextResponse.json(
68      { error: error instanceof Error ? error.message : 'Failed to create lead' },
69      { status: 500 }
70    );
71  }
72}
73
74export async function GET(request: NextRequest) {
75  const { searchParams } = new URL(request.url);
76  const resource = searchParams.get('resource') ?? 'leads';
77
78  try {
79    let method = '';
80    let params: Record<string, unknown> = {};
81
82    if (resource === 'leads') {
83      method = 'getLeads';
84      params = { limit: 50, offset: 0 };
85    } else {
86      return NextResponse.json({ error: 'Unknown resource' }, { status: 400 });
87    }
88
89    const result = await callSharpSpringAPI(method, params);
90    return NextResponse.json(result.result ?? {});
91  } catch (error) {
92    console.error('SharpSpring GET error:', error);
93    return NextResponse.json({ error: 'Failed to fetch SharpSpring data' }, { status: 500 });
94  }
95}

Your SharpSpring Account ID and Secret Key are found in your SharpSpring account under Settings → API Settings (the menu location may vary by SharpSpring version). The Account ID is a numeric identifier for your SharpSpring account, and the Secret Key is a longer alphanumeric string. Both are required for every API request. Open Vercel Dashboard → your project → Settings → Environment Variables and add SHARPSPRING_ACCOUNT_ID (your account ID) and SHARPSPRING_SECRET_KEY (your secret key). Select Production and Preview environments. For local testing, add both to your .env.local file. After adding variables to Vercel, trigger a redeployment. Note that SharpSpring's session ID is generated fresh for each request (it is a deterministic hash, not a session that expires) — there is no session management needed on your side beyond generating the hash correctly.

1# .env.local (do NOT commit)
2SHARPSPRING_ACCOUNT_ID=your_account_id_here
3SHARPSPRING_SECRET_KEY=your_secret_key_here

Update your V0-generated form's submit handler to POST form data to /api/sharpspring. The request body should be JSON with field names matching what your API route expects (emailAddress, firstName, lastName, phone, companyName, website, message). After deploying and testing, log in to your SharpSpring account and check CRM → Leads or CRM → Contacts to confirm new leads are appearing with the correct field values. You should also verify that any automatic lead scoring rules or campaign enrollment triggers are firing as expected — SharpSpring's automation can be configured to automatically add new leads to email sequences based on their source or other criteria. For complex SharpSpring integrations involving custom fields, lead scoring configuration, or campaign management via the API, RapidDev's team can assist with setup and troubleshooting.