Computer Code

This allows remote systems to post data into SwiftCloud for purpose usually of lead capture, though it can be used for anything – helpdesk, e-sign contract generation flows, etc.

GOAL (Most Common):
Send variables into an e-Sign Contract.

METHODS:

  • POST (simple and fast)
  • GET (URL string)
  • API (below)

NOTE: API in is easy, there’s no security risk. API outbound, for security reasons, is much more restrictive. You will need API keys and IP based restriction on outbound APIs.

POST (METHOD 1)

You can simply post any variables into a SwiftCloud doc, and as long as the variable matches, SwiftCloud will handle the rest. You can add “readonly” into the shortcode to make it look like regular text, not front-end-editable.

Post location: Simply post right to your actual doc URL. Ensure the variable names match in the source-code, and we’ll do the rest. You can optionally include hidden variables (like session ID, tracking variables).

GET (METHOD 2)

Simply append any variable to the end of your eSign doc / eDoc / Landing Page / Scheduler / etc – i.e.

https://[email protected]&extra_sessionID=1234

More Common Use Cases

  • Facebook Lead Form Ads – Will notify you, create the workroom, fire autoresponder messages, create the contact
  • Zapier, IFFFT, Tray.IO, n8n.io (API bridge systems) integrations
  • WordPress Forms for lead capture etc.
  • Any other data capture, lead capture

API INBOUND (METHOD 3)

Below is details for our incoming API using Json.

HOW TO USE IT

  1. Create a Form same as usual – go to your main drive page. Click the orange Create New button, select Form, and give it a name (just for you, not visible to clients). Move to a subfolder if you choose.
  2. Next, at the very top, choose API or Facebook. Both do the same, but Facebook will help you connect directly.
  3. In the pink box, set what you want to happen for the guest / client / form-filler – what email they should get if any, and any optional sequence of messages.
  4. In the blue box, set your own notification options. Email you? Email someone else? Configure as needed
  5. You’re done – most likely. More advanced optional controls are available in the grey box for non-english language controls, etc.

CODE EXAMPLE

Note 2 bits of data are always required for the absolute bare minimum:

  1. Form ID
  2. Email*

*Note we may soon allow mobile phone (with SMS verification); if you need this let us know.

POST TO: https://swiftcloud.ai/is/api/formhandlings

Login is not required. No data can be retrieved from this API. We may add IP restriction down the road if needed.

Set the header for API :  Content-Type : application/json

{"formid":"233F283",
"swift_name_both":"Tester Name",
"email":"[email protected]",
"FundsNeededFor":"new tractor"}

API Response:

success, fail

As always, if you have any questions let us know and we’ll update this entry to be more clear.

OUTBOUND API:

Contact us for details. You must have a static IP address for this (all websites do, but if you’re looking to connect a local point-of-sale cash register etc, this may be a bit more complex).

Was this article helpful?YesNo
Ah, sorry to hear this. We'll look into updating this item.
What could we do to improve this?