Write a headline, About or skills recommendation
Write a new headline, About section or list of skills to add, from the workspace's context and the account's notes. One open recommendation per field; asking again replaces it. Returns the review_path where a person approves it.
POST
https://app.trygtm.com/api/v1/linkedin/profiles/{profile_id}/recommendations- Scope
write- Cost
- 60 action credits per unit —
ai.linkedin.profile
Path parameters
profile_idstringrequired- The managed profile's id, from list_linkedin_profiles.
Headers
Idempotency-Keystringoptional- A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.
Body
fieldstringrequired- headline is the short line under the name; about is the long summary; skills are skills to add.
headlineaboutskills requeststring | nulloptional- What the person wants from it, in their words. Omit for the writer's own recommendation.
Request
curl -X POST https://app.trygtm.com/api/v1/linkedin/profiles/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/recommendations \
-H "Authorization: Bearer $TRYGTM_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"field": "state"
}'Response
{
"data": {
"item_id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
"revision_id": "8e9f0a1b-2c3d-4e4f-8a5b-6c7d8e9f0a1b",
"review_path": "/linkedin/review/2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
"next": "Nothing is published or changed on LinkedIn until a person with LinkedIn access in the workspace approves the exact change on the LinkedIn screen, or the account's automatic posting (which a person turned on there) schedules a post it wrote."
}
}