Documentation in many places is not updated and it is not aligned with the code snippets. For example, the section for Custom attributes:

https://developers.intercom.com/intercom-api-reference/reference#section-request-body-parameters/p>

In request body parameters, 'model' property is understood as a mandatory one. On the other hand, in CURL code snippet, it is missing, instead there is another one, not mentioned in a description, 'company'.

"data_type" property in the code snippet has "options" value, which is not listed in the documentation on the left side.

Also, phrase "Provide a set of hashes..." sounds odd, hash is mostly understood as non-readable representation of the input value, got from the transformation of the input value. From the context we can get a feeling that we just need to provide a set of text key/value pairs.

Overall, the right working code can be get only from the test and trials, which is not very efficient, and can lead to unexpected result.