Poketto

Submit form responses with Node.js

Learn how to send easily submit form responses from your apps, or server-side applications.

Prerequisites

To get the most out of this guide, you’ll need to:

Create an API key
Create a form

Install

bash

npm install poketto-sdk

Submit with Node.js

typescript

import { PokettoClient } from 'poketto-sdk';

// Initialize the client
const client = new PokettoClient({
	apiKey: 'your-api-key'
});

// Submit a form response
await client.submitResponse(
	'form-id',
	[
		{ field_id: 'name', value: 'John Doe' },
		{ field_id: 'email', value: 'john@example.com' },
		{ field_id: 'feedback', value: 'Great product!' }
	],
	// Optional respondent data
	{
		name: 'John Doe',
		email: 'john.doe@example.com'
	}
);

Methods

typescript

submitResponse(
    formId,
    fieldResponses, // array of field responses
    respondent?, // your user data
  )

Submit a form response with manual data.

typescript

await client.submitResponse(
	'form-123',
	[
		{ field_id: 'name', value: 'John Doe' },
		{ field_id: 'email', value: 'john@example.com' }
	],
	// Respondent data (user data)
	{
		name: 'John Doe',
		email: 'john@example.com'
	}
);

Submit a form response with auto-detected browser information.

typescript

await client.submitResponseWithBrowserInfo(
	'form-123',
	[{ field_id: 'feedback', value: 'Great service!' }],
	{
		email: 'user@example.com' // Optional respondent data
	}
);

Error Handling

typescript

import { PokettoError } from 'poketto-sdk';

try {
	await client.submitResponse('form-id', responses);
} catch (error) {
	if (error instanceof PokettoError) {
		console.error('Poketto Error:', {
			message: error.message,
			code: error.code,
			statusCode: error.statusCode,
			details: error.details
		});
	} else {
		console.error('Unknown error:', error);
	}
}