Brands allow you to customize the appearance of forms with your company name and logo. If you have an Enterprise Plan subscription, you can create multiple brands to support different business entities or white-label services. When creating a session or form, you can specify which brand to use, or use your default brand.
The body should be posted as multipart/form-data. Both the name and logo properties are required. The name must be unique across your brands. The logo file should be a PNG or JPEG image with a maximum file size of 1 MB.
There are several ways to authenticate your request, read our authentication guide to learn more.
POST https://api.nextform.app/brands/upload
{
"name": "Acme Corporation",
"logo": "(binary file data)",
"supportEmail": "support@acme.com",
"supportUrl": "https://acme.com/support",
"requestBody": "Please complete this tax form for our records.",
"remindBody": "This is a reminder to complete your tax form."
}The endpoint responds with a brand object, including the brand id which can be used when creating sessions or forms.
{
"id": "AbC123XyZ456",
"name": "Acme Corporation",
"logo": "brand-logos/abc123.png",
"supportEmail": "support@acme.com",
"supportUrl": "https://acme.com/support",
"requestBody": "Please complete this tax form for our records.",
"remindBody": "This is a reminder to complete your tax form.",
"createdAt": "2024-01-15T10:30:00.000Z"
}The name of your brand or company. This will be displayed at the top of forms. Brand names must be unique within your account.
A logo image file to upload. The file must be a PNG or JPEG image with a maximum file size of 1 MB. The logo will be stored on Nextform’s servers and displayed at the top of forms associated with this brand.
A support email address that will be displayed on forms for users who need assistance. This helps provide a point of contact for form signers.
A URL to your support page or help documentation. This provides an additional way for form signers to get assistance if needed.
Custom text to include in form request emails sent to contacts. This allows you to personalize the message when inviting someone to complete a form.
Custom text to include in reminder emails sent to contacts who haven’t completed their form. This allows you to personalize follow-up messages.
Once you’ve created a brand, you can specify it when creating a session by including the brandId property:
{
"formType": "w9",
"brandId": "AbC123XyZ456",
"signerEmail": "user@example.com"
}For more information about using brands with sessions, see the Create a Session documentation.