Job Custom Fields
Once a client activates the integration with your product and configures their pipeline, you are nearly ready to begin receiving webhook events. The last step it to activate the integration per job.
Your integration might need extra context from the client for certain jobs or applications. In this case, you can configure the fields required for the client to populate as part of their manual workflow.
Custom fields for jobs can be added to Jobylon through the /config/companies/{company_id}/jobendpoint. The Partner is able to choose a different configuration for each company. Alternatively, Partners can use the Configuration from endpoint feature. Which consists of an endpoint managed by the Partner where Jobylon will access the configuration.
See the payload schema for more details.
Once configured, custom fields materialize as forms the client can use to fill in the details of the integration when enabling it.
Jobylon provides an alternative way to update the Job Custom Fields. Instead of the partner using the /config/companies/{company_id}/job endpoint, Jobylon can access the configuration from an endpoint provided by the Partner. This method of updating the configuration is intended as a fallback and should only be utilized in specific circumstances.
When using this method, please note the following:
- The configuration must be the same across all companies. When pulling the configuration from the endpoint, all companies with the integration enabled will receive the updated configuration.
- The configuration is updated only once daily, at 4 AM Central European Time.
For more information regarding Configuration from endpoint, please check the field fetch_config_url under /config/webhook on Api Reference/OpenAPI.