- DATE:
- AUTHOR:
- The Eightfold team
Create Demand comments using API
WHAT'S INCLUDED
Demand comments could previously be added only manually in the product. This adds external API endpoints to create them programmatically — for example, to log an integration's action failures ("Could not add user — insufficient permissions") right on the relevant demand. You can post by the demand's Eightfold ID or its external ATS ID, send up to 100 comments in one call with each up to 5,000 characters, and use plain text or a safe subset of HTML. API-created comments appear in the demand's comments section alongside comments added in the product.
WHY IT MATTERS
Automate the audit trail. Integrations can record what happened — successes and failures — on the demand itself, where the team already looks.
Use the IDs you already have. Post by the Eightfold demand ID or by your external ATS demand ID.
Send one or many. Create a single comment or up to 100 in a single call.
FEATURE DETAILS
Who can access | Any user with permission to comment on demands (for example, Resource Managers or Project Managers), creating comments from a connected third-party system through the API |
Feature type | Default On |
Requirements | An Eightfold API token with write access to resource management. The demand's Eightfold ID or external ATS ID. |
GETTING STARTED
Admins: Use an API token with write access to resource management. Send a POST to the entity-comments endpoint (by Eightfold demand ID) or the ext-entity-comments endpoint (by external demand ID) with a JSON body containing a comments array. Each comment is plain text or a safe subset of HTML.
End users: Comments created through the API appear in the demand's comments section exactly like comments added in the product. A single-comment call also triggers the usual comment notifications; a multi-comment call creates the comments without notifications.
