forms

Upload an image

Uploads a logo and returns a URL. The upload does not change the form. You must put the response url into the corresponding field with a PATCH.

Send the request as multipart/form-data with two parts: file, the image, and use, where it will be shown.

usePut the returned url in
self_email_notification_logoself_email_notification.logo_url (the email you get on every submission)
auto_response_logoauto_response.logo_url (the reply the person who submitted receives)
after_submit_logoafter_submit.page.logo_url (the thank you page)
after_submit_logo_darkafter_submit.page.logo_dark_url (the thank you page in its dark look)

Uploads need a paid plan. Images may be up to 5 MB.

self_email_notification_logo and auto_response_logo only accept PNG, JPEG or GIF because email clients do not display WebP or SVG. The thank you page placements take all five.

post/v1/forms/{form_id}/images

Request

  • Base URL: https://api.formcarry.com
  • URL: https://api.formcarry.com/v1/forms/{form_id}/images
  • Auth: HTTP bearer

Path parameters

form_idstring required

The form's id, as shown in the dashboard and in the form's endpoint URL

Response

urlstring required

Example response

{
  "url": "https://cdn.formcarry.com/.../logo.png"
}

Changes

No recorded changes to this operation across all 1 revision of this API.