New Endpoints Released!

New Jobs Endpoints

Get Insurance Companies

  • Customers can consume the endpoint to get a list of Insurance Companies corresponding to the Company configured in the Company Settings.

GET /api/v2/company-settings/job-file-settings/insurance-companies


Set Job Insurance Company

  • Customers can consume the endpoint to assign an Insurance Company to an existing Job in AccuLynx, Job ID is required for this action.

PUT /api/v2/jobs/{jobId}/insurance/insurance-company


Create Job

  • Customers can consume the endpoint to create a job in AccuLynx with basic info. The only thing required to create a job is the contactId of an already existing contact.

POST /api/v2/jobs/Createjob


Financial Endpoint Updates

Job Accounting Integration Sync Status Changes

  • Customers can consume the endpoint to check the status of the accounting integration status.

GET /api/v2/jobs/{jobId}/accounting/integration-status


New Webhooks Released!

Jobs

Change to Approved Job Value

  • Customers can subscribe to this webhook to be notified of changes to the Approved Job Value of an existing Job in AccuLynx.

WEBHOOK job.financials.approved-value_changed


Change to Status

  • Customers can subscribe to this webhook to be notified of changes to the Statuses of an existing Job in an Elite AccuLynx account that has custom workflows enabled.

WEBHOOK job.milestone.status.current_changed


Job Contact Details changed

  • Customers can subscribe to this webhook to be notified of changes to the Contact Details on an existing Job in AccuLynx.

WEBHOOK contact_changed


Job Milestone changed

  • Customers can subscribe to this webhook to be notified of changes to the Milestone on an existing Job in AccuLynx.

WEBHOOK job.milestone.current_changed


Job Created

  • Customers can subscribe to this webhook to be notified when a new Job is created in AccuLynx.

WEBHOOK job_created


Job Updated

  • Customers can subscribe to this webhook to be notified when an existing Job is updated in AccuLynx.

WEBHOOK job_updated


Financials

Invoice Updates

  • Customers can subscribe to this webhook to be notified when an existing Invoice is updated in AccuLynx.

WEBHOOK invoice_updated


Invoice Voided

  • Customers can subscribe to this webhook to be notified when an existing Invoices is voided in AccuLynx.

WEBHOOK invoice_voided


Job Accounting Integration Sync Status Changes

  • Customers can subscribe to this webhook to be notified when a financial status is changed in AccuLynx.

WEBHOOK sync_status_changed


Improvements to existing Endpoints

Get milestones for a job

  • Customers can consume the endpoint to get milestone progress details including who made the change and the date of the milestone change, for an existing Job in AccuLynx.

GET /api/v2/jobs/{jobId}/milestones/


Get a single milestone for a job by milestone ID

  • Customers can consume the endpoint to get the current milestone & status for an active and existing Job, by milestone ID, in an Elite AccuLynx account that has custom workflows enabled.

GET /api/v2/jobs/{jobId}/milestones/{milestoneId}


Get the current milestone for a job

  • Customers can consume this endpoint to get the current milestone & status (as supported by account type) for an active and existing Job in AccuLynx.

GET /jobs/{jobId}/milestones/current


Get the list of active jobs for a location

  • Customers can consume this endpoint to get a list of active and existing Jobs in AccuLynx. This endpoint now includes the Job Priority.

GET /jobs


Get an active job by its JobID

  • Customers can consume this endpoint to get an active Job in AccuLynx. This endpoint now includes the Job Priority.

GET /jobs/{jobId}


Improvements to existing Webhooks!

Jobs

Job Milestone Status Changed

  • Customers can subscribe to this webhook to be notified when a job changes its status inside a given milestone.

WEBHOOK /api/v2/jobs/{jobId}/milestones/{milestoneId}/status/{statusId}


Introduction to Webhook Subscription

Subscribing to webhooks is a straightforward process that allows you to receive real-time notifications from AccuLynx whenever specific events occur. This integration enhances your application’s capabilities by automating data exchange and keeping your information up to date without manual intervention.

Basic Steps to Subscribe to a Webhook:

  1. Register an Endpoint: Create a URL on your server that will accept incoming webhook notifications.
  2. Use your Api Key to create a subscription using the API, and provide your registered URL.
  3. Choose Events: Select the types of events you wish to receive notifications for.
  4. Handle Notifications: Implement logic to process the incoming notifications on your server.
  5. Test Your Implementation: Ensure your system correctly handles webhook events and responds as expected.
  6. Monitor and Adjust: Keep an eye on your implementation for any errors and make necessary adjustments.

For more detailed instructions and guidelines on subscribing to webhooks, please refer to the full Documentation:

Webhooks End User Reference

AppConnections Release

by Andres Erazo

New Endpoints added

Contacts

Create Contact

  • User can easily add contact information

Search Contacts

  • User can quickly find and access relevant contact information, saving time and improving productivity in managing and interacting with contacts.

Contact Types List

  • User can easily access and retrieve a comprehensive list of contact types, allowing for accurate categorization and organization of contacts. Contact types are used to create a contact

Company

Get Company Photo and Video Tags

  • User can easily access and retrieve a comprehensive list of tags that can be applied when uploading photos or videos

Get Company Active Account Types

  • User can easily access and retrieve a comprehensive list of active account types. Account types are needed when creating a payment.

Get Company Account Type by Id

  • User can easily access and retrieve specific account type details when creating a payment. Account types are needed when creating a payment

Get Company Countries

  • User can easily access and reference the list of countries

Get Company States

  • User can easily access and reference the list of states

Get Job Categories of the company

  • User can easily access and retrieve a comprehensive list of job categories, enabling efficient categorization and organization of jobs, improved search and filtering capabilities, and streamlined project management and reporting processes within the company.

Get Trade Types of the company

  • User can easily access and retrieve a comprehensive list of trade types. Trade types are now supported when creating leads.

Get Work Types of a company

  • User can easily access and retrieve a comprehensive list of work types, allowing for accurate classification and organization of tasks, improved workflow management, and enhanced reporting and analysis capabilities within the company.

Get Active Lead Sources for a company

  • User can easily access and retrieve a comprehensive list of available lead sources specific to the current location. They can get lead sources with a reference to the parent if it's a child or get references to its children if it's a parent.

Get Company Lead Source by Id

  • User can easily access and retrieve a targeted lead source that is available and relevant to the current location. They get a lead source with a reference to its children if it's a parent.

Get Company Child Lead Source by Id

  • Get a lead source with a reference to its parent

Jobs

Create a job message

  • User can easily add and track job-related communication and updates as comments within the system. They can create a thread in a given job.

Reply to a job message

  • User can easily add a comment in response to a specific message within the job record.

Post Add JobDocument

  • User can easily attach and manage relevant documents directly within the job record, ensuring easy access to important information, improving collaboration and communication, and streamlining document management processes for increased efficiency and productivity.

Post Upload a photo or video to a job

  • User can easily attach visual media to the job record, improving communication and collaboration while streamlining project management.

Get a single milestone for a job by milestone Id

  • User can easily access specific milestone details, enabling efficient tracking, monitoring, and reporting of project progress, leading to improved project management and informed decision-making.

Get the current milestone for a job

  • The user can access real-time updates on the current milestone, enabling accurate tracking of project progress, improved decision-making, and effective communication among team members, ultimately streamlining project management and ensuring timely completion of tasks.

Post Create Payment Paid

  • User can easily record and track payment transactions, ensuring accurate financial records, enhanced transparency, and improved financial management for the company.

Post Create Payment Received

  • User can easily record and track payment receipts, ensuring accurate financial records and improved cash flow management.

Post Create Payment Additional Job Expenses

  • User can easily record and track additional expenses related to a specific job, ensuring accurate financial records, and improved cost management.

Get Job Payments

  • User can easily access and retrieve comprehensive payment details, including transaction history, payment amounts, and dates, facilitating accurate financial tracking

Job change history

  • User can easily access and review a comprehensive log of all past actions related to the job, enabling improved visibility, accountability, and transparency in project management, facilitating effective communication, tracking changes, and ensuring accurate documentation for enhanced collaboration and decision-making

Get Financials by JobId

  • User can understand the Approved Job Value, totals from Financial Worksheet and Amendments, as well as the option to include all the Financial Worksheet and Amendments.

Get Invoices by JobId

  • User can understand the Approved Job Value, totals from Financial Worksheet and Amendments, as well as the option to include all the Financial Worksheet and Amendments.

Financials

Get Financials by Financial Id

  • User can easily access and retrieve comprehensive financial information related to the job, including costs, expenses, payments, and profitability metrics

Get Financial Worksheet by Financial Id

  • User can get the Financial Worksheet information for a given Job (FinancialId).

Get Financial Amendments by Financial Id

  • User can get the Amendments for a given Job (FinancialId).

Get Financial Amendment by Amendment Id

  • User can get the Amendment by its ID.

Invoices

Get Invoice by Id

  • User can get the invoice by its ID