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.
Best answer by Sam
View original