Actions524
- AI Helper Actions
- Tool Actions
- API Threshold Actions
- Appointment Actions
- Billing Code Actions
- Billing Items Actions
- Change Request Link Actions
- Checklist Library Actions
- Checklist Library Item Actions
- Classification Icon Actions
- Company Actions
- Company Alert Actions
- Company Location Actions
- Company Note Actions
- Company Webhook Actions
- Company Site Configuration Actions
- Configuration Item Actions
- Configuration Item Billing Product Association Actions
- Configuration Item Category Actions
- Configuration Item Category UDF Association Actions
- Configuration Item DNS Record Actions
- Configuration Item Note Actions
- Configuration Item Related Item Actions
- Configuration Item SSL Subject Alternative Name Actions
- Configuration Item Type Actions
- Configuration Item Webhook Actions
- Contact Actions
- Contact Webhook Actions
- Contact Groups Actions
- Contact Group Contacts Actions
- Contract Actions
- Contract Block Actions
- Contract Block Hour Factor Actions
- Contract Billing Rule Actions
- Contract Charge Actions
- Contract Exclusion Billing Code Actions
- Contract Exclusion Role Actions
- Contract Exclusion Sets Actions
- Contract Exclusion Set Excluded Role Actions
- Contract Exclusion Set Excluded Work Type Actions
- Contract Milestone Actions
- Contract Note Actions
- Contract Rate Actions
- Contract Role Costs Actions
- Contract Retainer Actions
- Contract Service Actions
- Contract Service Adjustment Actions
- Contract Service Bundle Adjustment Actions
- Contract Service Bundle Actions
- Contract Service Bundle Unit Actions
- Contract Ticket Purchase Actions
- Department Actions
- Project Phase Actions
- Quote Item Actions
- Quote Location Actions
- Quote Template Actions
- Resource Actions
- Resource Role Actions
- Resource Role Queue Actions
- Search Filter Actions
- Service Actions
- Service Call Actions
- Subscription Actions
- Subscription Period Actions
- Ticket Category Actions
- Ticket Category Field Default Actions
- Ticket History Actions
- Ticket Note Actions
Contract Retainer → Create
AI-generatedOverview
This node operation creates a new Contract Retainer in the Autotask PSA system. It is useful for automating the addition of contract retainers, which are financial arrangements or agreements related to contracts, directly from workflows. For example, a business can use this node to programmatically add retainers to contracts when certain conditions are met, such as after a contract is approved or a client signs an agreement.
Use Case Examples
- Automatically create a contract retainer when a new contract is created in the system.
- Add a retainer to a contract as part of a billing or project setup workflow.
Properties
| Name | Meaning |
|---|---|
| Dry Run | Whether to return a request preview instead of executing the operation. Useful for testing and validation. |
| Fields | The fields to map for the contract retainer creation. This allows specifying the data to be sent to Autotask for the new contract retainer. |
Output
JSON
id- The unique identifier of the created contract retainer.contractId- The ID of the contract to which the retainer is associated.amount- The amount specified for the contract retainer.status- The status of the contract retainer after creation.createdDate- The date and time when the contract retainer was created.
Dependencies
- Autotask PSA REST API
- API authentication credentials
Troubleshooting
- Ensure API credentials are correctly configured and have permissions to create contract retainers.
- If 'Dry Run' is enabled, no changes will be made; disable it to perform actual creation.
- Check for required fields in the 'Fields' mapping to avoid validation errors from the API.
- Common errors include authentication failures, missing required fields, or invalid field values. Verify the input data and API access.
Links
- Autotask PSA REST API Documentation - Official API documentation for Autotask PSA, useful for understanding the contract retainer resource and its fields.