So you are building your first connector using Connector Builder, and you are wondering what exactly the Request Root Key and the Response Root Key are intended to deliver; well, do not worry anymore, I will provide you with a quick introduction to this concept and allow you to understand a little better how to make use of these two "keys" and properly approach this feature.
Let's start from the very beginning, let's use the payload below as an illustration:
As you can see, this payload contains a parent property called "data" and a child called "contacts"; now, let's say that our aim was to only return "contacts", in that case, you would have to essentially go through the parent "data" to be able to tap into the "contacts" child property (i.e. the dot notation => data.contacts). To avoid this extra effort, we have essentially implemented the Request and Response Root Keys to allow you to access the child property directly without having to handle additional logic on your side.
How does it work? So let's use our payload above as an example again. Let's say you want to return the contact object as the payload, all that you would have to set up in your request is "data" as your Request Root Key as shown here:
and our system automatically interprets that request to return only the child/children of the "data" parent property, here is a little GIF to help you conceptualize the approach: