diff --git a/src/__tests__/IterableEmbeddedMessage.test.ts b/src/__tests__/IterableEmbeddedMessage.test.ts
new file mode 100644
index 000000000..64385e99f
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessage.test.ts
@@ -0,0 +1,163 @@
+import { IterableEmbeddedMessage } from '../embedded/classes/IterableEmbeddedMessage';
+import { IterableEmbeddedMessageMetadata } from '../embedded/classes/IterableEmbeddedMessageMetadata';
+import { IterableEmbeddedMessageElements } from '../embedded/classes/IterableEmbeddedMessageElements';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessage', () => {
+  it('should create an instance with all properties', () => {
+    Iterable.logger.log('iterableEmbeddedMessage_fromDict_all_properties');
+
+    const dict = {
+      metadata: {
+        messageId: 'msg-123',
+        placementId: 1,
+        campaignId: 456,
+        isProof: false,
+      },
+      elements: {
+        title: 'Awesome Title',
+        body: 'Radical Body Text',
+        mediaUrl: 'https://example.com/image.jpg',
+        mediaUrlCaption: 'Check out this sick image!',
+        defaultAction: {
+          type: 'openUrl',
+          data: 'https://example.com',
+        },
+        buttons: [
+          {
+            id: 'button-1',
+            title: 'Click Me!',
+            action: {
+              type: 'openUrl',
+              data: 'https://example.com/button1',
+            },
+          },
+        ],
+        text: [
+          {
+            id: 'text-1',
+            text: 'Some cool text',
+            type: 'body',
+          },
+        ],
+      },
+      payload: {
+        customKey: 'customValue',
+        anotherKey: 123,
+      },
+    };
+
+    const message = IterableEmbeddedMessage.fromDict(dict);
+
+    expect(message).toBeInstanceOf(IterableEmbeddedMessage);
+
+    // Check metadata
+    expect(message.metadata).toBeInstanceOf(IterableEmbeddedMessageMetadata);
+    expect(message.metadata.messageId).toBe('msg-123');
+    expect(message.metadata.placementId).toBe(1);
+    expect(message.metadata.campaignId).toBe(456);
+    expect(message.metadata.isProof).toBe(false);
+
+    // Check elements
+    expect(message.elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(message.elements?.title).toBe('Awesome Title');
+    expect(message.elements?.body).toBe('Radical Body Text');
+    expect(message.elements?.mediaUrl).toBe('https://example.com/image.jpg');
+    expect(message.elements?.mediaUrlCaption).toBe(
+      'Check out this sick image!'
+    );
+
+    // Check payload
+    expect(message.payload).toEqual({
+      customKey: 'customValue',
+      anotherKey: 123,
+    });
+  });
+
+  it('should create an instance with only required metadata', () => {
+    Iterable.logger.log('iterableEmbeddedMessage_fromDict_required_only');
+
+    const dict = {
+      metadata: {
+        messageId: 'msg-123',
+        placementId: 1,
+        isProof: false,
+      },
+    };
+
+    const message = IterableEmbeddedMessage.fromDict(dict);
+
+    expect(message).toBeInstanceOf(IterableEmbeddedMessage);
+    expect(message.metadata).toBeInstanceOf(IterableEmbeddedMessageMetadata);
+    expect(message.metadata.messageId).toBe('msg-123');
+    expect(message.metadata.placementId).toBe(1);
+    expect(message.metadata.campaignId).toBeUndefined();
+    expect(message.metadata.isProof).toBe(false);
+    expect(message.elements).toBeUndefined();
+    expect(message.payload).toBeUndefined();
+  });
+
+  it('should throw an error if metadata is missing', () => {
+    Iterable.logger.log('iterableEmbeddedMessage_fromDict_missing_metadata');
+
+    const dict = {
+      elements: {
+        title: 'Some Title',
+        body: 'Some Body',
+      },
+    };
+
+    expect(() => IterableEmbeddedMessage.fromDict(dict)).toThrow(
+      'metadata is required'
+    );
+  });
+
+  it('should create an instance with elements but no payload', () => {
+    Iterable.logger.log('iterableEmbeddedMessage_fromDict_elements_only');
+
+    const dict = {
+      metadata: {
+        messageId: 'msg-123',
+        placementId: 1,
+        isProof: false,
+      },
+      elements: {
+        title: 'Elements Only',
+        body: 'No payload here',
+      },
+    };
+
+    const message = IterableEmbeddedMessage.fromDict(dict);
+
+    expect(message).toBeInstanceOf(IterableEmbeddedMessage);
+    expect(message.metadata).toBeInstanceOf(IterableEmbeddedMessageMetadata);
+    expect(message.elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(message.elements?.title).toBe('Elements Only');
+    expect(message.elements?.body).toBe('No payload here');
+    expect(message.payload).toBeUndefined();
+  });
+
+  it('should create an instance with payload but no elements', () => {
+    Iterable.logger.log('iterableEmbeddedMessage_fromDict_payload_only');
+
+    const dict = {
+      metadata: {
+        messageId: 'msg-123',
+        placementId: 1,
+        isProof: false,
+      },
+      payload: {
+        someData: 'someValue',
+      },
+    };
+
+    const message = IterableEmbeddedMessage.fromDict(dict);
+
+    expect(message).toBeInstanceOf(IterableEmbeddedMessage);
+    expect(message.metadata).toBeInstanceOf(IterableEmbeddedMessageMetadata);
+    expect(message.elements).toBeUndefined();
+    expect(message.payload).toEqual({
+      someData: 'someValue',
+    });
+  });
+});
diff --git a/src/__tests__/IterableEmbeddedMessageDefaultAction.test.ts b/src/__tests__/IterableEmbeddedMessageDefaultAction.test.ts
new file mode 100644
index 000000000..bf99bc5b8
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessageDefaultAction.test.ts
@@ -0,0 +1,40 @@
+import { IterableEmbeddedMessageDefaultAction } from '../embedded/classes/IterableEmbeddedMessageDefaultAction';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessageDefaultAction', () => {
+  it('should create an instance with the correct properties', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageDefaultAction_fromDict_valid_dictionary'
+    );
+
+    const dict = { type: 'openUrl', data: 'https://example.com' };
+    const action = IterableEmbeddedMessageDefaultAction.fromDict(dict);
+    expect(action).toBeInstanceOf(IterableEmbeddedMessageDefaultAction);
+    expect(action.type).toBe('openUrl');
+    expect(action.data).toBe('https://example.com');
+  });
+
+  it('should create an instance from a dictionary with data omitted', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageDefaultAction_fromDict_valid_dictionary_with_data_omitted'
+    );
+
+    const dict = { type: 'action://join', data: '' };
+    const action = IterableEmbeddedMessageDefaultAction.fromDict(dict);
+    expect(action).toBeInstanceOf(IterableEmbeddedMessageDefaultAction);
+    expect(action.type).toBe('action://join');
+    expect(action.data).toBe('');
+  });
+
+  it('should throw an error if type is missing in fromDict', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageDefaultAction_fromDict_invalid_dictionary_missing_type'
+    );
+
+    const dict = { data: 'foo' };
+
+    expect(() => IterableEmbeddedMessageDefaultAction.fromDict(dict)).toThrow(
+      'type is required'
+    );
+  });
+});
diff --git a/src/__tests__/IterableEmbeddedMessageElements.test.ts b/src/__tests__/IterableEmbeddedMessageElements.test.ts
new file mode 100644
index 000000000..00028da5f
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessageElements.test.ts
@@ -0,0 +1,214 @@
+import { IterableEmbeddedMessageElements } from '../embedded/classes/IterableEmbeddedMessageElements';
+import { IterableEmbeddedMessageDefaultAction } from '../embedded/classes/IterableEmbeddedMessageDefaultAction';
+import { IterableEmbeddedMessageElementsButton } from '../embedded/classes/IterableEmbeddedMessageElementsButton';
+import { IterableEmbeddedMessageText } from '../embedded/classes/IterableEmbeddedMessageText';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessageElements', () => {
+  it('should create an instance with all properties', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_all_properties'
+    );
+
+    const dict = {
+      title: 'Awesome Title',
+      body: 'Radical Body Text',
+      mediaUrl: 'https://example.com/image.jpg',
+      mediaUrlCaption: 'Check out this sick image!',
+      defaultAction: {
+        type: 'openUrl',
+        data: 'https://example.com',
+      },
+      buttons: [
+        {
+          id: 'button-1',
+          title: 'Click Me!',
+          action: {
+            type: 'openUrl',
+            data: 'https://example.com/button1',
+          },
+        },
+        {
+          id: 'button-2',
+          title: 'Close',
+          action: {
+            type: 'action://dismiss',
+          },
+        },
+      ],
+      text: [
+        {
+          id: 'text-1',
+          text: 'Some cool text',
+          type: 'body',
+        },
+        {
+          id: 'text-2',
+          text: 'More radical text',
+          type: 'subtitle',
+        },
+      ],
+    };
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBe('Awesome Title');
+    expect(elements.body).toBe('Radical Body Text');
+    expect(elements.mediaUrl).toBe('https://example.com/image.jpg');
+    expect(elements.mediaUrlCaption).toBe('Check out this sick image!');
+
+    // Check defaultAction
+    expect(elements.defaultAction).toBeInstanceOf(
+      IterableEmbeddedMessageDefaultAction
+    );
+    expect(elements.defaultAction?.type).toBe('openUrl');
+    expect(elements.defaultAction?.data).toBe('https://example.com');
+
+    // Check buttons
+    expect(elements.buttons).toHaveLength(2);
+    const firstButton = elements
+      .buttons![0] as IterableEmbeddedMessageElementsButton;
+    expect(firstButton).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(firstButton.id).toBe('button-1');
+    expect(firstButton.title).toBe('Click Me!');
+    expect(firstButton.action?.type).toBe('openUrl');
+    expect(firstButton.action?.data).toBe('https://example.com/button1');
+
+    const secondButton = elements
+      .buttons![1] as IterableEmbeddedMessageElementsButton;
+    expect(secondButton).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(secondButton.id).toBe('button-2');
+    expect(secondButton.title).toBe('Close');
+    expect(secondButton.action?.type).toBe('action://dismiss');
+    expect(secondButton.action?.data).toBeUndefined();
+
+    // Check text elements
+    expect(elements.text).toHaveLength(2);
+    const firstText = elements.text![0] as IterableEmbeddedMessageText;
+    expect(firstText).toBeInstanceOf(IterableEmbeddedMessageText);
+    expect(firstText.id).toBe('text-1');
+    expect(firstText.text).toBe('Some cool text');
+    expect(firstText.type).toBe('body');
+
+    const secondText = elements.text![1] as IterableEmbeddedMessageText;
+    expect(secondText).toBeInstanceOf(IterableEmbeddedMessageText);
+    expect(secondText.id).toBe('text-2');
+    expect(secondText.text).toBe('More radical text');
+    expect(secondText.type).toBe('subtitle');
+  });
+
+  it('should create an instance with title and body', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_title_and_body'
+    );
+
+    const dict = {
+      title: 'Simple Title',
+      body: 'Simple Body',
+    };
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBe('Simple Title');
+    expect(elements.body).toBe('Simple Body');
+    expect(elements.mediaUrl).toBeUndefined();
+    expect(elements.mediaUrlCaption).toBeUndefined();
+    expect(elements.defaultAction).toBeUndefined();
+    expect(elements.buttons).toBeUndefined();
+    expect(elements.text).toBeUndefined();
+  });
+
+  it('should create an instance with no title or body', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_no_title_or_body'
+    );
+
+    const dict = {};
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBeUndefined();
+    expect(elements.body).toBeUndefined();
+    expect(elements.mediaUrl).toBeUndefined();
+    expect(elements.mediaUrlCaption).toBeUndefined();
+    expect(elements.defaultAction).toBeUndefined();
+    expect(elements.buttons).toBeUndefined();
+    expect(elements.text).toBeUndefined();
+  });
+
+  it('should create an instance with media properties', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_media_properties'
+    );
+
+    const dict = {
+      title: 'Media Title',
+      body: 'Media Body',
+      mediaUrl: 'https://example.com/media.jpg',
+      mediaUrlCaption: 'Check this out!',
+    };
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBe('Media Title');
+    expect(elements.body).toBe('Media Body');
+    expect(elements.mediaUrl).toBe('https://example.com/media.jpg');
+    expect(elements.mediaUrlCaption).toBe('Check this out!');
+    expect(elements.defaultAction).toBeUndefined();
+    expect(elements.buttons).toBeUndefined();
+    expect(elements.text).toBeUndefined();
+  });
+
+  it('should create an instance with defaultAction only', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_defaultAction_only'
+    );
+
+    const dict = {
+      title: 'Action Title',
+      body: 'Action Body',
+      defaultAction: {
+        type: 'openUrl',
+        data: 'https://example.com',
+      },
+    };
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBe('Action Title');
+    expect(elements.body).toBe('Action Body');
+    expect(elements.defaultAction).toBeInstanceOf(
+      IterableEmbeddedMessageDefaultAction
+    );
+    expect(elements.defaultAction?.type).toBe('openUrl');
+    expect(elements.defaultAction?.data).toBe('https://example.com');
+    expect(elements.buttons).toBeUndefined();
+    expect(elements.text).toBeUndefined();
+  });
+
+  it('should create an instance with empty arrays for buttons and text', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElements_fromDict_empty_arrays'
+    );
+
+    const dict = {
+      title: 'Empty Arrays Title',
+      body: 'Empty Arrays Body',
+      buttons: [],
+      text: [],
+    };
+
+    const elements = IterableEmbeddedMessageElements.fromDict(dict);
+
+    expect(elements).toBeInstanceOf(IterableEmbeddedMessageElements);
+    expect(elements.title).toBe('Empty Arrays Title');
+    expect(elements.body).toBe('Empty Arrays Body');
+    expect(elements.buttons).toHaveLength(0);
+    expect(elements.text).toHaveLength(0);
+  });
+});
diff --git a/src/__tests__/IterableEmbeddedMessageElementsButton.test.ts b/src/__tests__/IterableEmbeddedMessageElementsButton.test.ts
new file mode 100644
index 000000000..1524d1c5b
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessageElementsButton.test.ts
@@ -0,0 +1,91 @@
+import { IterableEmbeddedMessageElementsButton } from '../embedded/classes/IterableEmbeddedMessageElementsButton';
+import { IterableEmbeddedMessageElementsButtonAction } from '../embedded/classes/IterableEmbeddedMessageElementsButtonAction';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessageButton', () => {
+  it('should create an instance with all properties including button action', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageButton_fromDict_all_properties'
+    );
+
+    const dict = {
+      id: 'button-123',
+      title: 'Click Me!',
+      action: { type: 'openUrl', data: 'https://example.com' },
+    };
+
+    const button = IterableEmbeddedMessageElementsButton.fromDict(dict);
+
+    expect(button).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(button.id).toBe('button-123');
+    expect(button.title).toBe('Click Me!');
+    expect(button.action).toBeInstanceOf(
+      IterableEmbeddedMessageElementsButtonAction
+    );
+    expect(button.action?.type).toBe('openUrl');
+    expect(button.action?.data).toBe('https://example.com');
+  });
+
+  it('should create an instance with only required properties', () => {
+    Iterable.logger.log('iterableEmbeddedMessageButton_fromDict_required_only');
+
+    const dict = { id: 'button-123' };
+
+    const button = IterableEmbeddedMessageElementsButton.fromDict(dict);
+
+    expect(button).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(button.id).toBe('button-123');
+    expect(button.title).toBeUndefined();
+    expect(button.action).toBeUndefined();
+  });
+
+  it('should create an instance with title but no action', () => {
+    Iterable.logger.log('iterableEmbeddedMessageButton_fromDict_title_only');
+
+    const dict = {
+      id: 'button-123',
+      title: 'Click Me!',
+    };
+
+    const button = IterableEmbeddedMessageElementsButton.fromDict(dict);
+
+    expect(button).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(button.id).toBe('button-123');
+    expect(button.title).toBe('Click Me!');
+    expect(button.action).toBeUndefined();
+  });
+
+  it('should throw an error if id is missing in fromDict', () => {
+    Iterable.logger.log('iterableEmbeddedMessageButton_fromDict_missing_id');
+
+    const dict = {
+      title: 'Click Me!',
+      action: { type: 'openUrl', data: 'https://example.com' },
+    };
+
+    expect(() => IterableEmbeddedMessageElementsButton.fromDict(dict)).toThrow(
+      'id is required'
+    );
+  });
+
+  it('should handle button action with only type', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageButton_fromDict_action_type_only'
+    );
+
+    const dict = {
+      id: 'button-123',
+      action: { type: 'close' },
+    };
+
+    const button = IterableEmbeddedMessageElementsButton.fromDict(dict);
+
+    expect(button).toBeInstanceOf(IterableEmbeddedMessageElementsButton);
+    expect(button.id).toBe('button-123');
+    expect(button.action).toBeInstanceOf(
+      IterableEmbeddedMessageElementsButtonAction
+    );
+    expect(button.action?.type).toBe('close');
+    expect(button.action?.data).toBeUndefined();
+  });
+});
diff --git a/src/__tests__/IterableEmbeddedMessageElementsButtonAction.test.ts b/src/__tests__/IterableEmbeddedMessageElementsButtonAction.test.ts
new file mode 100644
index 000000000..fa172cb7c
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessageElementsButtonAction.test.ts
@@ -0,0 +1,40 @@
+import { IterableEmbeddedMessageElementsButtonAction } from '../embedded/classes/IterableEmbeddedMessageElementsButtonAction';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessageDefaultAction', () => {
+  it('should create an instance with the correct properties', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElementsButtonAction_fromDict_valid_dictionary'
+    );
+
+    const dict = { type: 'openUrl', data: 'https://example.com' };
+    const action = IterableEmbeddedMessageElementsButtonAction.fromDict(dict);
+    expect(action).toBeInstanceOf(IterableEmbeddedMessageElementsButtonAction);
+    expect(action.type).toBe('openUrl');
+    expect(action.data).toBe('https://example.com');
+  });
+
+  it('should create an instance from a dictionary with data omitted', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElementsButtonAction_fromDict_valid_dictionary_with_data_omitted'
+    );
+
+    const dict = { type: 'action://join', data: '' };
+    const action = IterableEmbeddedMessageElementsButtonAction.fromDict(dict);
+    expect(action).toBeInstanceOf(IterableEmbeddedMessageElementsButtonAction);
+    expect(action.type).toBe('action://join');
+    expect(action.data).toBe('');
+  });
+
+  it('should throw an error if type is missing in fromDict', () => {
+    Iterable.logger.log(
+      'iterableEmbeddedMessageElementsButtonAction_fromDict_invalid_dictionary_missing_type'
+    );
+
+    const dict = { data: 'foo' };
+
+    expect(() =>
+      IterableEmbeddedMessageElementsButtonAction.fromDict(dict)
+    ).toThrow('type is required');
+  });
+});
diff --git a/src/__tests__/IterableEmbeddedMessageText.test.ts b/src/__tests__/IterableEmbeddedMessageText.test.ts
new file mode 100644
index 000000000..10b3e2ffe
--- /dev/null
+++ b/src/__tests__/IterableEmbeddedMessageText.test.ts
@@ -0,0 +1,38 @@
+import { IterableEmbeddedMessageText } from '../embedded/classes/IterableEmbeddedMessageText';
+import { Iterable } from '../core/classes/Iterable';
+
+describe('IterableEmbeddedMessageText', () => {
+  it('should create an instance from a dictionary with all properties', () => {
+    Iterable.logger.log('iterableEmbeddedMessageText_fromDict_all_properties');
+
+    const dict = { id: 'text-123', text: 'Hello World!', type: 'heading' };
+    const text = IterableEmbeddedMessageText.fromDict(dict);
+
+    expect(text).toBeInstanceOf(IterableEmbeddedMessageText);
+    expect(text.id).toBe('text-123');
+    expect(text.text).toBe('Hello World!');
+    expect(text.type).toBe('heading');
+  });
+
+  it('should create an instance from a dictionary with only required properties', () => {
+    Iterable.logger.log('iterableEmbeddedMessageText_fromDict_required_only');
+
+    const dict = { id: 'text-123' };
+    const text = IterableEmbeddedMessageText.fromDict(dict);
+
+    expect(text).toBeInstanceOf(IterableEmbeddedMessageText);
+    expect(text.id).toBe('text-123');
+    expect(text.text).toBeUndefined();
+    expect(text.type).toBeUndefined();
+  });
+
+  it('should throw an error if id is missing in fromDict', () => {
+    Iterable.logger.log('iterableEmbeddedMessageText_fromDict_missing_id');
+
+    const dict = { text: 'Hello World!', type: 'heading' };
+
+    expect(() => IterableEmbeddedMessageText.fromDict(dict)).toThrow(
+      'id is required'
+    );
+  });
+});
diff --git a/src/embedded/classes/IterableEmbeddedMessage.ts b/src/embedded/classes/IterableEmbeddedMessage.ts
new file mode 100644
index 000000000..c264bf262
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessage.ts
@@ -0,0 +1,61 @@
+import { IterableEmbeddedMessageMetadata } from './IterableEmbeddedMessageMetadata';
+import { IterableEmbeddedMessageElements } from './IterableEmbeddedMessageElements';
+
+/**
+ * IterableEmbeddedMessage represents an embedded message.
+ */
+export class IterableEmbeddedMessage {
+  /** The metadata of the embedded message */
+  metadata: IterableEmbeddedMessageMetadata;
+  /** The elements of the embedded message */
+  elements?: IterableEmbeddedMessageElements;
+  /** The custom payload of the embedded message */
+  payload?: Record<string, unknown>;
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessage`.
+   *
+   * @param metadata - The metadata of the embedded message.
+   * @param elements - The elements of the embedded message.
+   * @param payload - The custom payload of the embedded message.
+   */
+  constructor(
+    metadata: IterableEmbeddedMessageMetadata,
+    elements?: IterableEmbeddedMessageElements,
+    payload?: Record<string, unknown>
+  ) {
+    this.metadata = metadata;
+    this.elements = elements;
+    this.payload = payload;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessage` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessage` instance.
+   * @returns A new instance of `IterableEmbeddedMessage` initialized with the provided dictionary properties.
+   */
+  static fromDict(dict: Partial<EmbeddedMessageDict>): IterableEmbeddedMessage {
+    if (!dict.metadata) {
+      throw new Error('metadata is required');
+    }
+    const metadata = IterableEmbeddedMessageMetadata.fromDict(dict.metadata);
+    const elements = dict.elements
+      ? IterableEmbeddedMessageElements.fromDict(dict.elements)
+      : undefined;
+    const payload = dict.payload;
+    return new IterableEmbeddedMessage(metadata, elements, payload);
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for the embedded message.
+ */
+interface EmbeddedMessageDict {
+  /** The metadata of the embedded message */
+  metadata: IterableEmbeddedMessageMetadata;
+  /** The elements of the embedded message */
+  elements: IterableEmbeddedMessageElements;
+  /** The custom payload of the embedded message */
+  payload: Record<string, unknown>;
+}
diff --git a/src/embedded/classes/IterableEmbeddedMessageDefaultAction.ts b/src/embedded/classes/IterableEmbeddedMessageDefaultAction.ts
new file mode 100644
index 000000000..06a36c00e
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessageDefaultAction.ts
@@ -0,0 +1,53 @@
+/**
+ * IterableEmbeddedMessageDefaultAction represents the default action defined as
+ * a response to user events for an embedded message
+ */
+export class IterableEmbeddedMessageDefaultAction {
+  /**
+   * The type of iterable action
+   * For custom actions, the type is `action://` prefix followed by a custom action name
+   */
+  readonly type: string;
+
+  /**
+   * The url for the action when the type is `openUrl`
+   * For custom actions, data is empty
+   */
+  readonly data?: string;
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageDefaultAction`.
+   *
+   * @param type - The type of iterable action
+   * @param data - The url for the action when the type is `openUrl`
+   */
+  constructor(type: string, data?: string) {
+    this.type = type;
+    this.data = data;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageDefaultAction` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessageDefaultAction` instance.
+   * @returns A new instance of `IterableEmbeddedMessageDefaultAction` initialized with the provided dictionary properties.
+   */
+  static fromDict(
+    dict: Partial<EmbeddedMessageDefaultActionDict>
+  ): IterableEmbeddedMessageDefaultAction {
+    if (!dict.type) {
+      throw new Error('type is required');
+    }
+    return new IterableEmbeddedMessageDefaultAction(dict.type, dict.data);
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for the embedded message default action.
+ */
+export interface EmbeddedMessageDefaultActionDict {
+  /** The type of the action */
+  type: string;
+  /** The url for the action when the type is `openUrl` */
+  data?: string;
+}
diff --git a/src/embedded/classes/IterableEmbeddedMessageElements.ts b/src/embedded/classes/IterableEmbeddedMessageElements.ts
new file mode 100644
index 000000000..73280b7e4
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessageElements.ts
@@ -0,0 +1,108 @@
+import { IterableEmbeddedMessageDefaultAction } from './IterableEmbeddedMessageDefaultAction';
+import { IterableEmbeddedMessageElementsButton } from './IterableEmbeddedMessageElementsButton';
+import { IterableEmbeddedMessageText } from './IterableEmbeddedMessageText';
+
+/**
+ * IterableEmbeddedMessageElements represents the elements of an embedded message.
+ */
+export class IterableEmbeddedMessageElements {
+  /** The title of the embedded message */
+  readonly title?: string;
+  /** The body of the embedded message */
+  readonly body?: string;
+  /** The url of the embedded message image */
+  readonly mediaUrl?: string;
+  /** The caption of the embedded message image */
+  readonly mediaUrlCaption?: string;
+  /** The default action of the embedded message */
+  readonly defaultAction?: IterableEmbeddedMessageDefaultAction;
+  /** The buttons of the embedded message */
+  readonly buttons?: IterableEmbeddedMessageElementsButton[];
+  /** The text elements of the embedded message */
+  readonly text?: IterableEmbeddedMessageText[];
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageElements`.
+   *
+   * @param title - The title of the embedded message.
+   * @param body - The body of the embedded message.
+   * @param mediaUrl - The url of the embedded message image.
+   * @param mediaUrlCaption - The caption of the embedded message image.
+   * @param defaultAction - The default action of the embedded message.
+   * @param buttons - The buttons of the embedded message.
+   * @param text - The text elements of the embedded message.
+   */
+  constructor(
+    title?: string,
+    body?: string,
+    mediaUrl?: string,
+    mediaUrlCaption?: string,
+    defaultAction?: IterableEmbeddedMessageDefaultAction,
+    buttons?: IterableEmbeddedMessageElementsButton[],
+    text?: IterableEmbeddedMessageText[]
+  ) {
+    this.title = title;
+    this.body = body;
+    this.mediaUrl = mediaUrl;
+    this.mediaUrlCaption = mediaUrlCaption;
+    this.defaultAction = defaultAction;
+    this.buttons = buttons;
+    this.text = text;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageElements` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessageElements` instance.
+   * @returns A new instance of `IterableEmbeddedMessageElements` initialized with the provided dictionary properties.
+   */
+  static fromDict(
+    dict: Partial<EmbeddedMessageElementsDict>
+  ): IterableEmbeddedMessageElements {
+    const title = dict.title;
+    const body = dict.body;
+    const mediaUrl = dict.mediaUrl;
+    const mediaUrlCaption = dict.mediaUrlCaption;
+    const defaultAction = dict.defaultAction
+      ? IterableEmbeddedMessageDefaultAction.fromDict(dict.defaultAction)
+      : undefined;
+
+    const buttons = dict.buttons?.map((button) =>
+      IterableEmbeddedMessageElementsButton.fromDict(button)
+    );
+
+    const text = dict.text?.map((text) =>
+      IterableEmbeddedMessageText.fromDict(text)
+    );
+
+    return new IterableEmbeddedMessageElements(
+      title,
+      body,
+      mediaUrl,
+      mediaUrlCaption,
+      defaultAction,
+      buttons,
+      text
+    );
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for the embedded message elements.
+ */
+export interface EmbeddedMessageElementsDict {
+  /** The title of the embedded message */
+  title?: string;
+  /** The body of the embedded message */
+  body?: string;
+  /** The url of the embedded message image */
+  mediaUrl?: string;
+  /** The caption of the embedded message image */
+  mediaUrlCaption?: string;
+  /** The default action of the embedded message */
+  defaultAction?: IterableEmbeddedMessageDefaultAction;
+  /** The buttons of the embedded message */
+  buttons?: IterableEmbeddedMessageElementsButton[];
+  /** The text elements of the embedded message */
+  text?: IterableEmbeddedMessageText[];
+}
diff --git a/src/embedded/classes/IterableEmbeddedMessageElementsButton.ts b/src/embedded/classes/IterableEmbeddedMessageElementsButton.ts
new file mode 100644
index 000000000..64a516a20
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessageElementsButton.ts
@@ -0,0 +1,64 @@
+import { IterableEmbeddedMessageElementsButtonAction } from './IterableEmbeddedMessageElementsButtonAction';
+
+/**
+ * IterableEmbeddedMessageElementsButton represents a button in an embedded message.
+ */
+export class IterableEmbeddedMessageElementsButton {
+  /** The ID for the embedded message button */
+  readonly id: string;
+  /** The title for the embedded message button */
+  readonly title?: string;
+  /** The action for the embedded message button */
+  readonly action?: IterableEmbeddedMessageElementsButtonAction;
+
+  /**
+   * Creates an instance of IterableEmbeddedMessageButton.
+   *
+   * @param id - The ID for the embedded message button.
+   * @param title - The title for the embedded message button.
+   * @param action - The action for the embedded message button.
+   */
+  constructor(
+    id: string,
+    title?: string,
+    action?: IterableEmbeddedMessageElementsButtonAction
+  ) {
+    this.id = id;
+    this.title = title;
+    this.action = action;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageButton` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessageButton` instance.
+   * @returns A new instance of `IterableEmbeddedMessageButton` initialized with the provided dictionary properties.
+   */
+  static fromDict(
+    dict: Partial<EmbeddedMessageElementsButtonDict>
+  ): IterableEmbeddedMessageElementsButton {
+    if (!dict.id) {
+      throw new Error('id is required');
+    }
+    const action = dict.action
+      ? IterableEmbeddedMessageElementsButtonAction.fromDict(dict.action)
+      : undefined;
+    return new IterableEmbeddedMessageElementsButton(
+      dict.id,
+      dict.title,
+      action
+    );
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for the embedded message button.
+ */
+export interface EmbeddedMessageElementsButtonDict {
+  /** The ID for the embedded message button */
+  id: string;
+  /** The title for the embedded message button */
+  title?: string;
+  /** The action for the embedded message button */
+  action?: IterableEmbeddedMessageElementsButtonAction;
+}
diff --git a/src/embedded/classes/IterableEmbeddedMessageElementsButtonAction.ts b/src/embedded/classes/IterableEmbeddedMessageElementsButtonAction.ts
new file mode 100644
index 000000000..4061e2c6a
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessageElementsButtonAction.ts
@@ -0,0 +1,56 @@
+/**
+ * IterableEmbeddedMessageElementsButtonAction represents an action defined as
+ * a response to user events for an embedded message button
+ */
+export class IterableEmbeddedMessageElementsButtonAction {
+  /**
+   * The type of iterable action
+   * For custom actions, the type is `action://` prefix followed by a custom action name
+   */
+  readonly type: string;
+
+  /**
+   * The url for the action when the type is `openUrl`
+   * For custom actions, data is empty
+   */
+  readonly data?: string;
+
+  /**
+   * Creates an instance of IterableEmbeddedMessageElementsButtonAction.
+   *
+   * @param type - The type of the action.
+   * @param data - Optional data associated with the action.
+   */
+  constructor(type: string, data?: string) {
+    this.type = type;
+    this.data = data;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageElementsButtonAction` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessageElementsButtonAction` instance.
+   * @returns A new instance of `IterableEmbeddedMessageElementsButtonAction` initialized with the provided dictionary properties.
+   */
+  static fromDict(
+    dict: Partial<EmbeddedMessageButtonActionDict>
+  ): IterableEmbeddedMessageElementsButtonAction {
+    if (!dict.type) {
+      throw new Error('type is required');
+    }
+    return new IterableEmbeddedMessageElementsButtonAction(
+      dict.type,
+      dict.data
+    );
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for the embedded message button action.
+ */
+export interface EmbeddedMessageButtonActionDict {
+  /** The type of the action */
+  type: string;
+  /** The data associated with the action */
+  data?: string;
+}
diff --git a/src/embedded/classes/IterableEmbeddedMessageText.ts b/src/embedded/classes/IterableEmbeddedMessageText.ts
new file mode 100644
index 000000000..06a553476
--- /dev/null
+++ b/src/embedded/classes/IterableEmbeddedMessageText.ts
@@ -0,0 +1,51 @@
+/**
+ * IterableEmbeddedMessageText represents a text element in an embedded message.
+ */
+export class IterableEmbeddedMessageText {
+  /** The id of the text element */
+  readonly id: string;
+  /** The text of the text element */
+  readonly text?: string;
+  /** The type of the text element */
+  readonly type?: string;
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageText`.
+   *
+   * @param id - The id of the text element
+   * @param text - The text of the text element
+   * @param type - The type of the text element
+   */
+  constructor(id: string, text?: string, type?: string) {
+    this.id = id;
+    this.text = text;
+    this.type = type;
+  }
+
+  /**
+   * Creates an instance of `IterableEmbeddedMessageText` from a dictionary object.
+   *
+   * @param dict - The dictionary object containing the properties to initialize the `IterableEmbeddedMessageText` instance.
+   * @returns A new instance of `IterableEmbeddedMessageText` initialized with the provided dictionary properties.
+   */
+  static fromDict(
+    dict: Partial<EmbeddedMessageTextDict>
+  ): IterableEmbeddedMessageText {
+    if (!dict.id) {
+      throw new Error('id is required');
+    }
+    return new IterableEmbeddedMessageText(dict.id, dict.text, dict.type);
+  }
+}
+
+/**
+ * An interface defining the dictionary object containing the properties for an embedded message text.
+ */
+export interface EmbeddedMessageTextDict {
+  /** The id of the text element */
+  id: string;
+  /** The text of the text element */
+  text?: string;
+  /** The type of the text element */
+  type?: string;
+}
diff --git a/src/embedded/classes/index.ts b/src/embedded/classes/index.ts
index 9b605f651..3b0ab3fa8 100644
--- a/src/embedded/classes/index.ts
+++ b/src/embedded/classes/index.ts
@@ -1,2 +1,5 @@
 export * from './IterableEmbeddedManager';
 export * from './IterableEmbeddedPlacement';
+export * from './IterableEmbeddedMessageElementsButton';
+export * from './IterableEmbeddedMessageElementsButtonAction';
+export * from './IterableEmbeddedMessageMetadata';