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/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>;
+}