AP-9488 # Add optional emailAddress property to createJob() job `…

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - `sortBy` and `sortDirection` to `FormSearchOptions`
 - `emailClassificationId` to form schema
+- optional `emailAddress` property to `createJob()` job `details` for sending job notification emails
 
 ## [13.1.7] - 2026-06-18
 

src/classes/Jobs.ts

@@ -16,6 +16,7 @@ const newJobSchema = Joi.object()
       description: Joi.string(),
       type: Joi.string(),
       priority: Joi.number(),
+      emailAddress: Joi.string().email(),
     }),
   })
 
@@ -54,6 +55,7 @@ export default class Jobs extends OneBlinkAPI {
    *       description: 'Job description',
    *       type: 'Type',
    *       priority: 3,
+   *       emailAddress: 'user@domain.io',
    *     },
    *   }
    *

tests/jobs.test.ts

@@ -95,6 +95,36 @@ describe('Jobs SDK Class', () => {
           ).rejects.toThrow('"details.priority" must be a number')
         })
       })
+
+      describe('should reject with correct validation errors for "details.emailAddress"', () => {
+        test('string', async () => {
+          const jobs = await getJobsSdk()
+          return expect(
+            jobs.createJob({
+              username: 'username',
+              formId: 1,
+              details: {
+                title: 'job title',
+                // @ts-expect-error Expecting throw
+                emailAddress: 123,
+              },
+            }),
+          ).rejects.toThrow('"details.emailAddress" must be a string')
+        })
+        test('invalid email', async () => {
+          const jobs = await getJobsSdk()
+          return expect(
+            jobs.createJob({
+              username: 'username',
+              formId: 1,
+              details: {
+                title: 'job title',
+                emailAddress: 'not-an-email',
+              },
+            }),
+          ).rejects.toThrow('"details.emailAddress" must be a valid email')
+        })
+      })
     })
 
     describe('API Calls', () => {