feat: Add IT Contacts API

.oagen-manifest.json

@@ -1,7 +1,6 @@
 {
   "version": 2,
   "language": "node",
-  "generatedAt": "2026-06-16T18:02:10.415Z",
   "files": [
     "src/api-keys/interfaces/create-validation-options.interface.ts",
     "src/api-keys/interfaces/delete-api-key-options.interface.ts",
@@ -82,6 +81,31 @@
     "src/groups/serializers/index.ts",
     "src/groups/serializers/update-group.serializer.ts",
     "src/groups/serializers/user-organization-membership-base-list-data.serializer.ts",
+    "src/it-contacts/fixtures/create-it-contact.json",
+    "src/it-contacts/fixtures/invite-it-contact.json",
+    "src/it-contacts/fixtures/it-contact-list-list-metadata.json",
+    "src/it-contacts/fixtures/it-contact-list.json",
+    "src/it-contacts/fixtures/it-contact.json",
+    "src/it-contacts/interfaces/create-it-contact-options.interface.ts",
+    "src/it-contacts/interfaces/create-it-contact.interface.ts",
+    "src/it-contacts/interfaces/delete-it-contact-options.interface.ts",
+    "src/it-contacts/interfaces/index.ts",
+    "src/it-contacts/interfaces/invite-it-contact-intents.interface.ts",
+    "src/it-contacts/interfaces/invite-it-contact-options.interface.ts",
+    "src/it-contacts/interfaces/invite-it-contact.interface.ts",
+    "src/it-contacts/interfaces/it-contact-list-list-metadata.interface.ts",
+    "src/it-contacts/interfaces/it-contact-list.interface.ts",
+    "src/it-contacts/interfaces/it-contact.interface.ts",
+    "src/it-contacts/interfaces/list-it-contacts-options.interface.ts",
+    "src/it-contacts/interfaces/revoke-it-contact-options.interface.ts",
+    "src/it-contacts/it-contacts.spec.ts",
+    "src/it-contacts/it-contacts.ts",
+    "src/it-contacts/serializers/create-it-contact.serializer.ts",
+    "src/it-contacts/serializers/index.ts",
+    "src/it-contacts/serializers/invite-it-contact.serializer.ts",
+    "src/it-contacts/serializers/it-contact-list-list-metadata.serializer.ts",
+    "src/it-contacts/serializers/it-contact-list.serializer.ts",
+    "src/it-contacts/serializers/it-contact.serializer.ts",
     "src/pipes/fixtures/connected-account.json",
     "src/pipes/fixtures/data-integration-access-token-response-access-token.json",
     "src/pipes/fixtures/data-integration-access-token-response.json",

src/index.ts

@@ -24,6 +24,7 @@ export * from './events/interfaces';
 export * from './feature-flags/interfaces';
 export { FeatureFlagsRuntimeClient } from './feature-flags/runtime-client';
 export * from './groups/interfaces';
+export * from './it-contacts/interfaces';
 export * from './multi-factor-auth/interfaces';
 export * from './organizations/interfaces';
 export * from './organization-domains/interfaces';

src/it-contacts/fixtures/create-it-contact.json

@@ -0,0 +1,3 @@
+{
+  "email": "it-contact@example.com"
+}

src/it-contacts/fixtures/invite-it-contact.json

@@ -0,0 +1,3 @@
+{
+  "intents": ["sso", "directory_sync"]
+}

src/it-contacts/fixtures/it-contact-list-list-metadata.json

@@ -0,0 +1,4 @@
+{
+  "before": "it_contact_01HXYZ123456789ABCDEFGHIJ",
+  "after": "it_contact_01HXYZ987654321KJIHGFEDCBA"
+}

src/it-contacts/fixtures/it-contact-list.json

@@ -0,0 +1,16 @@
+{
+  "object": "list",
+  "data": [
+    {
+      "object": "it_contact",
+      "id": "it_contact_01HXYZ123456789ABCDEFGHIJ",
+      "email": "it-contact@example.com",
+      "created_at": "2026-01-15T12:00:00.000Z",
+      "updated_at": "2026-01-15T12:00:00.000Z"
+    }
+  ],
+  "list_metadata": {
+    "before": "it_contact_01HXYZ123456789ABCDEFGHIJ",
+    "after": "it_contact_01HXYZ987654321KJIHGFEDCBA"
+  }
+}

src/it-contacts/fixtures/it-contact.json

@@ -0,0 +1,7 @@
+{
+  "object": "it_contact",
+  "id": "it_contact_01HXYZ123456789ABCDEFGHIJ",
+  "email": "it-contact@example.com",
+  "created_at": "2026-01-15T12:00:00.000Z",
+  "updated_at": "2026-01-15T12:00:00.000Z"
+}

src/it-contacts/interfaces/create-it-contact-options.interface.ts

@@ -0,0 +1,8 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface CreateItContactOptions {
+  /** The ID of the organization. */
+  organizationId: string;
+  /** The email address of the IT contact. */
+  email: string;
+}

src/it-contacts/interfaces/create-it-contact.interface.ts

@@ -0,0 +1,10 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface CreateItContact {
+  /** The email address of the IT contact. */
+  email: string;
+}
+
+export interface CreateItContactResponse {
+  email: string;
+}

src/it-contacts/interfaces/delete-it-contact-options.interface.ts

@@ -0,0 +1,8 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface DeleteItContactOptions {
+  /** The ID of the organization. */
+  organizationId: string;
+  /** The ID of the IT contact. */
+  contactId: string;
+}

src/it-contacts/interfaces/index.ts

@@ -0,0 +1,11 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export * from './create-it-contact-options.interface';
+export * from './create-it-contact.interface';
+export * from './delete-it-contact-options.interface';
+export * from './invite-it-contact-intents.interface';
+export * from './invite-it-contact-options.interface';
+export * from './invite-it-contact.interface';
+export * from './it-contact.interface';
+export * from './list-it-contacts-options.interface';
+export * from './revoke-it-contact-options.interface';

src/it-contacts/interfaces/invite-it-contact-intents.interface.ts

@@ -0,0 +1,12 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export const InviteItContactIntents = {
+  SSO: 'sso',
+  DirectorySync: 'directory_sync',
+  LogStreams: 'log_streams',
+  DomainVerification: 'domain_verification',
+  BringYourOwnKey: 'bring_your_own_key',
+} as const;
+
+export type InviteItContactIntents =
+  (typeof InviteItContactIntents)[keyof typeof InviteItContactIntents];

src/it-contacts/interfaces/invite-it-contact-options.interface.ts

@@ -0,0 +1,12 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type { InviteItContactIntents } from './invite-it-contact-intents.interface';
+
+export interface InviteItContactOptions {
+  /** The ID of the organization. */
+  organizationId: string;
+  /** The ID of the IT contact. */
+  contactId: string;
+  /** The Admin Portal features that the IT contact can configure. */
+  intents: InviteItContactIntents[];
+}

src/it-contacts/interfaces/invite-it-contact.interface.ts

@@ -0,0 +1,12 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type { InviteItContactIntents } from './invite-it-contact-intents.interface';
+
+export interface InviteItContact {
+  /** The Admin Portal features that the IT contact can configure. */
+  intents: InviteItContactIntents[];
+}
+
+export interface InviteItContactResponse {
+  intents: InviteItContactIntents[];
+}

src/it-contacts/interfaces/it-contact-list-list-metadata.interface.ts

@@ -0,0 +1,14 @@
+// This file is auto-generated by oagen. Do not edit.
+
+/** Pagination cursors for navigating between pages of results. */
+export interface ItContactListListMetadata {
+  /** An object ID that defines your place in the list. When the ID is not present, you are at the start of the list. */
+  before: string | null;
+  /** An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. */
+  after: string | null;
+}
+
+export interface ItContactListListMetadataResponse {
+  before: string | null;
+  after: string | null;
+}

src/it-contacts/interfaces/it-contact-list.interface.ts

@@ -0,0 +1,22 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type { ItContact, ItContactResponse } from './it-contact.interface';
+import type {
+  ItContactListListMetadata,
+  ItContactListListMetadataResponse,
+} from './it-contact-list-list-metadata.interface';
+
+export interface ItContactList {
+  /** Indicates this is a list response. */
+  object: 'list';
+  /** The list of records for the current page. */
+  data: ItContact[];
+  /** Pagination cursors for navigating between pages of results. */
+  listMetadata: ItContactListListMetadata;
+}
+
+export interface ItContactListResponse {
+  object: 'list';
+  data: ItContactResponse[];
+  list_metadata: ItContactListListMetadataResponse;
+}

src/it-contacts/interfaces/it-contact.interface.ts

@@ -0,0 +1,22 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface ItContact {
+  /** The IT Contact object. */
+  object: 'it_contact';
+  /** The unique ID of the IT Contact. */
+  id: string;
+  /** The email address of the IT Contact. */
+  email: string;
+  /** An ISO 8601 timestamp. */
+  createdAt: Date;
+  /** An ISO 8601 timestamp. */
+  updatedAt: Date;
+}
+
+export interface ItContactResponse {
+  object: 'it_contact';
+  id: string;
+  email: string;
+  created_at: string;
+  updated_at: string;
+}

src/it-contacts/interfaces/list-it-contacts-options.interface.ts

@@ -0,0 +1,6 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface ListItContactsOptions {
+  /** The ID of the organization. */
+  organizationId: string;
+}

src/it-contacts/interfaces/revoke-it-contact-options.interface.ts

@@ -0,0 +1,8 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export interface RevokeItContactOptions {
+  /** The ID of the organization. */
+  organizationId: string;
+  /** The ID of the IT contact. */
+  contactId: string;
+}

src/it-contacts/it-contacts.spec.ts

@@ -0,0 +1,111 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import fetch from 'jest-fetch-mock';
+import {
+  fetchOnce,
+  fetchURL,
+  fetchMethod,
+  fetchBody,
+} from '../common/utils/test-utils';
+import { WorkOS } from '../workos';
+
+import itContactListFixture from './fixtures/it-contact-list.json';
+import itContactFixture from './fixtures/it-contact.json';
+
+const workos = new WorkOS('sk_test_Sz3IQjepeSWaI4cMS4ms4sMuU');
+
+describe('ItContacts', () => {
+  beforeEach(() => fetch.resetMocks());
+
+  describe('listItContacts', () => {
+    it('returns the expected result', async () => {
+      fetchOnce(itContactListFixture);
+
+      const result = await workos.itContacts.listItContacts({
+        organizationId: 'test_organizationId',
+      });
+
+      expect(fetchMethod()).toBe('GET');
+      expect(new URL(String(fetchURL())).pathname).toBe(
+        '/organizations/test_organizationId/it_contacts',
+      );
+      expect(result.object).toBe('list');
+    });
+  });
+
+  describe('createItContact', () => {
+    it('sends the correct request and returns result', async () => {
+      fetchOnce(itContactFixture);
+
+      const result = await workos.itContacts.createItContact({
+        organizationId: 'test_organizationId',
+        email: 'test@example.com',
+      });
+
+      expect(fetchMethod()).toBe('POST');
+      expect(new URL(String(fetchURL())).pathname).toBe(
+        '/organizations/test_organizationId/it_contacts',
+      );
+      expect(fetchBody()).toEqual(
+        expect.objectContaining({ email: 'test@example.com' }),
+      );
+      expect(result.object).toBe('it_contact');
+      expect(result.id).toBe('it_contact_01HXYZ123456789ABCDEFGHIJ');
+      expect(result.email).toBe('it-contact@example.com');
+      expect(result.createdAt.toISOString()).toBe('2026-01-15T12:00:00.000Z');
+      expect(result.updatedAt.toISOString()).toBe('2026-01-15T12:00:00.000Z');
+    });
+  });
+
+  describe('deleteItContact', () => {
+    it('sends a DELETE request', async () => {
+      fetchOnce({}, { status: 204 });
+
+      await workos.itContacts.deleteItContact({
+        organizationId: 'test_organizationId',
+        contactId: 'test_contactId',
+      });
+
+      expect(fetchMethod()).toBe('DELETE');
+      expect(new URL(String(fetchURL())).pathname).toBe(
+        '/organizations/test_organizationId/it_contacts/test_contactId',
+      );
+    });
+  });
+
+  describe('inviteItContact', () => {
+    it('sends the request', async () => {
+      fetchOnce({});
+
+      await workos.itContacts.inviteItContact({
+        organizationId: 'test_organizationId',
+        contactId: 'test_contactId',
+        intents: ['sso'],
+      });
+
+      expect(fetchMethod()).toBe('POST');
+      expect(new URL(String(fetchURL())).pathname).toBe(
+        '/organizations/test_organizationId/it_contacts/test_contactId/invite',
+      );
+      expect(fetchBody()).toEqual(
+        expect.objectContaining({ intents: ['sso'] }),
+      );
+    });
+  });
+
+  describe('revokeItContact', () => {
+    it('sends the request', async () => {
+      fetchOnce({});
+
+      await workos.itContacts.revokeItContact({
+        organizationId: 'test_organizationId',
+        contactId: 'test_contactId',
+      });
+
+      expect(fetchMethod()).toBe('POST');
+      expect(new URL(String(fetchURL())).pathname).toBe(
+        '/organizations/test_organizationId/it_contacts/test_contactId/revoke',
+      );
+    });
+  });
+});