How to add objects in Integry – Integry

When a particular event occurs in your app, your app calls Integry with a payload describing the event. Since Integry acts an an intermediary platform between your app and the app where you wish to transfer data, you need to specify an object for that payload in Integry. You then have to associate that object to the action you want to perform in the third-party app. That object helps your users map your app's fields with the TPA's fields at the time of action setup.

Let's say, you're using Integry Actions to add a subscriber in Mailchimp whenever a lead is created in your app. Your app will send a payload to Integry when a lead is created in your app. That payload may look like this:

{
  "lead_id": "98765",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "phone": "555-123-4567",
  "company": "ABC Corporation",
  "job_title": "Marketing Manager",
  "source": "Website Form",
  "created_at": "2023-07-27T14:25:00Z"
}

Let's see how to add a Lead object in Integry.

Add an Object in Integry

Go to Account Settings > Objects
Click + Add Object
Click + Custom object
Enter a title and specify JSON payload for the object
Click Add object

Set object to Action

Set the "Lead" object to Mailchimp's "Add Subscriber" action.

Go to Actions tab in Integry webapp
Click Add Actions +
Select object

Select action
Click Add actions
Click the three dost menu
Click Configure
We will automatically map the action's fields according to the object's attributes.
If you want to change the mapping, you can click Configure on the field
You can set its default value by selecting another field from the dropdown. These fields are coming from the payload you defined while creating the object.
1. The mapping is correct here so we won't change it
2. Click Save if you have made any changes

How to edit an object

To add a subscriber in Mailchimp, it's mandatory to select a subscription status. However, the object we created above didn't have this attribute. So, you must specify a status attribute in your payload. If you want to auto-map the field "Subscription Status" for your users, you have to edit the Lead object in Integry.

Editing object in your Integry account

Click the selected object on the top right corner of the configure screen
Hover over the object and click Edit
Add any attributes. For example, in this case we'll add "status": "Subscribed"
Save object
Click the configure button on the field "Subscription Status"
Click the default value field
Scroll down and you'll see the status field in the dropdown menu. Select it and save the configuration

Editing object when embedding the actions

To embed actions in your app, you have to generate the embed code. The embed code contains all the objects in your account.

If you want to make changes to an object after generating and downloading the embed code, you have to add the code in this way:

"objects":{
      "Lead":{
      "status": "Subscribed",

Note: If you make a change, try setting up the action again and you'll notice that the new/modified fields show up immediately.