API entry block

Another door to let your contacts come through. Let them come in. It's rude to keep people waiting at the door. Be a good host. 

• From the Flow block library, drag & drop the API entry block to the Flow canvas.
• Hover over the block to see the settings and delete button.
• Click on the settings button. 

API entry settings

• You can map the data in two ways: map using an API call or map by simply Pasting a JSON (with all the data already in it).
• If you're using the API, click Map using an API call.
• Go to the right endpoint in our API to map. Click the authorize/padlock button to log in and get access.
• Click Try it out.
• Click the Copy Map URL and copy/paste the URL to the flowID and blockID parameters.
• Copy/paste the JSON body.
• Click the Execute button.
• If everything is in order the HTTP Status Code should be 200. 
• When you get a 200 HTTP Status Code, go back to the Flow.
• The Manage API entry mapping window should be open and simply map your fields with the Loopify fields. You can map your fields to one of the Contact, Consent or Job Fields. You can also +Add as a new campaign field or Ignore a specific field. Click OK.
• If you need you could Manage mapping or Restart mapping. Restarting will allow you to select a different or the same method of mapping.
• Connect it to another block. Send communication to the contacts and don't leave them hanging.

Note: If you want to map a date field to a Loopify field of type 'date', you should enter the date in the file in the following format: 2019-06-06T09:13:38.04Z

Trigger API entry block

The next step is triggering the API block so the campaign can start. The campaign can't start without triggering the API block. Make sure your campaign is ready.

• Go live.
• Go to the right endpoint in our API to trigger it.
• Click Try it out.
• Click the Copy Trigger URL button and copy/paste the URL to the flowID and blockID parameters.
• Copy/paste the same JSON body you used for mapping.
• Click the Execute button.
• If everything is in order the HTTP Status Code should be 200. 
• After you get a 200 HTTP Status Code, go back to Flow.

This will send the communication to the contacts. If you deactivate or freeze the flow campaign you can't trigger the API block.

Tip: If your flow is active you don't have to freeze it to preview the mapping. From the block settings, you can click View mapping and a new window will pop up and show you how your data is mapped with the Loopify fields! 

Tab reports

The summary of the tab reports can be previewed after activating the flow campaign. In an active flow, hover over the block, click the settings button and access the API Entry block reports through the reports tab. Here you can see the number of contacts that have arrived in your flow campaign through the API block.

There is also a date picker where you can select a specific date range and see the data for the selected period. The pre-set date range is All time.

Note: You can still access the tab reports even after deactivating the flow.

Next campaign entry block on the reading list - the Import block.