{"id":2476,"date":"2026-10-30T09:00:00","date_gmt":"2026-10-30T03:30:00","guid":{"rendered":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/"},"modified":"2026-11-15T22:00:03","modified_gmt":"2026-11-15T16:30:03","slug":"salesforce-metadata-tooling-api","status":"publish","type":"post","link":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/","title":{"rendered":"Salesforce Metadata API and Tooling API Explained"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API moves configuration rather than data. Objects, fields, page layouts, Apex classes, Flows, profiles and permission sets all travel through it. Every release tool you have used, including the command line and change set alternatives, sits on top of it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Tooling API is its faster, smaller cousin. Where the Metadata API deals in packages and asynchronous jobs, the Tooling API reads and edits one item at a time and answers immediately. Development tools use it to open a class, save a change and keep working.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><a href=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-1.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"640\" src=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-1-1024x640.png\" alt=\"Salesforce Metadata API diagram showing package, validation and deployment steps\" class=\"wp-image-2474\" srcset=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-1-1024x640.png 1024w, https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-1-300x188.png 300w, https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-1-768x480.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Caption: A deployment is one transaction, so either every component lands or none of them do.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What Is the Salesforce Metadata API<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API is an API for configuration, not records. You send a package, which is a set of metadata files plus a manifest naming what is inside.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n&lt;Package xmlns=\"http:\/\/soap.sforce.com\/2006\/04\/metadata\"&gt;\n  &lt;types&gt;\n    &lt;members&gt;Course__c&lt;\/members&gt;\n    &lt;name&gt;CustomObject&lt;\/name&gt;\n  &lt;\/types&gt;\n  &lt;types&gt;\n    &lt;members&gt;CourseService&lt;\/members&gt;\n    &lt;name&gt;ApexClass&lt;\/name&gt;\n  &lt;\/types&gt;\n  &lt;version&gt;62.0&lt;\/version&gt;\n&lt;\/Package&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API reads a manifest called <code>package.xml<\/code>, and it is the piece people argue about most. A wildcard pulls everything of a type, a named member pulls one item, and the difference decides how long your retrieve takes.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Manifest entry<\/th><th>What it fetches<\/th><\/tr><\/thead><tbody><tr><td>A single member name<\/td><td>Just that component<\/td><\/tr><tr><td>An asterisk as the member<\/td><td>Every component of that type<\/td><\/tr><tr><td>Several types in one file<\/td><td>A mixed package<\/td><\/tr><tr><td>A folder path for reports<\/td><td>Reports inside that folder<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Retrieve and Deploy<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API has two verbs that matter, retrieve and deploy. Pipelines built on them are covered in the post on <a href=\"https:\/\/swapnilzambare.com\/blog\/salesforce-ci-cd-github-actions\/\">CI and CD for Salesforce<\/a>. Retrieve pulls configuration out of an org into files. Deploy pushes files into an org.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sf project retrieve start --manifest manifest\/package.xml\nsf project deploy start --source-dir force-app --test-level RunLocalTests<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Both are asynchronous. The call returns a job id, and you poll that id until the job finishes. A large deployment can take many minutes, mostly spent running tests.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Why the Salesforce Metadata API Matters<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Benefit<\/th><th>What it gives a team<\/th><\/tr><\/thead><tbody><tr><td>Repeatable releases<\/td><td>The same package deploys to every org<\/td><\/tr><tr><td>Version control<\/td><td>Configuration lives in Git like code<\/td><\/tr><tr><td>Validation before the fact<\/td><td>A check only deploy proves it will work<\/td><\/tr><tr><td>All or nothing<\/td><td>No half applied release<\/td><\/tr><tr><td>Automation<\/td><td>A pipeline can deploy with no clicks<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The validation point changes how teams work. A check only deployment runs every test against production without changing anything, so a release can be proven safe hours before the window opens. The post on <a href=\"https:\/\/swapnilzambare.com\/blog\/salesforce-cli-deploy-retrieve-metadata\/\">the Salesforce CLI<\/a> covers the tooling around that.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What the Tooling API Does Differently<\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><a href=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-2.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"640\" src=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-2-1024x640.png\" alt=\"Salesforce Metadata API and Tooling API comparison diagram\" class=\"wp-image-2475\" srcset=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-2-1024x640.png 1024w, https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-2-300x188.png 300w, https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-diagram-2-768x480.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Caption: Release pipelines use one, and editors and admin tools use the other.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Tooling API sits beside the Salesforce Metadata API and exposes metadata as objects you can query with SOQL style syntax over REST.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/services\/data\/v62.0\/tooling\/query\/?q=SELECT+Id,Name,Body+FROM+ApexClass+WHERE+Name='CourseService'<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">That single call returns the class body immediately. No package, no zip, no job id. It is why a code editor can open a class in under a second.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Task<\/th><th>Metadata API<\/th><th>Tooling API<\/th><\/tr><\/thead><tbody><tr><td>Deploy 300 components<\/td><td>Yes<\/td><td>No<\/td><\/tr><tr><td>Read one Apex class body<\/td><td>Clumsy<\/td><td>Yes<\/td><\/tr><tr><td>Create a debug log trace flag<\/td><td>No<\/td><td>Yes<\/td><\/tr><tr><td>Run a single test and read coverage<\/td><td>Limited<\/td><td>Yes<\/td><\/tr><tr><td>Retrieve every profile<\/td><td>Yes<\/td><td>No<\/td><\/tr><tr><td>Edit a custom field description live<\/td><td>Possible but heavy<\/td><td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The Tooling API also exposes things the Salesforce Metadata API does not, such as code coverage results, trace flags and the symbol table for a class. Those exist for tools, not for releases.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">A Real Salesforce Metadata API Example<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API fixed a real release problem for us. Bright Path Tutors had one. Configuration moved between orgs through change sets, built by hand each time, and two releases in a row missed a permission set.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Problem<\/th><th>What it cost<\/th><\/tr><\/thead><tbody><tr><td>Change sets built by hand<\/td><td>An hour per release, every release<\/td><\/tr><tr><td>No record of what shipped<\/td><td>Arguments about what changed<\/td><\/tr><tr><td>Missed components<\/td><td>Two hotfixes in one quarter<\/td><\/tr><tr><td>No dry run<\/td><td>Failures found during the window<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">We moved to a package in Git with a pipeline.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Step<\/th><th>What runs<\/th><\/tr><\/thead><tbody><tr><td>Pull request opened<\/td><td>A check only deployment to a sandbox<\/td><\/tr><tr><td>Review approved<\/td><td>Tests run again with RunLocalTests<\/td><\/tr><tr><td>Merge to main<\/td><td>A real deployment to the release sandbox<\/td><\/tr><tr><td>Release window<\/td><td>The same package deploys to production<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Measure<\/th><th>Before<\/th><th>After<\/th><\/tr><\/thead><tbody><tr><td>Time to prepare a release<\/td><td>60 minutes<\/td><td>5 minutes<\/td><\/tr><tr><td>Missed components per quarter<\/td><td>2<\/td><td>0<\/td><\/tr><tr><td>Record of what shipped<\/td><td>A screenshot<\/td><td>A Git commit<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The missed components figure is the one that convinced the team. The same package deployed everywhere, so a component could not be in one org and absent from another.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Destructive Changes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API needs a second manifest to delete configuration.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n&lt;Package xmlns=\"http:\/\/soap.sforce.com\/2006\/04\/metadata\"&gt;\n  &lt;types&gt;\n    &lt;members&gt;Old_Field__c&lt;\/members&gt;\n    &lt;name&gt;CustomField&lt;\/name&gt;\n  &lt;\/types&gt;\n&lt;\/Package&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Save that as <code>destructiveChangesPost.xml<\/code> alongside an empty <code>package.xml<\/code>, and the deployment removes those components. Always run it as a check only deployment first, because a deleted field takes its data with it.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>File name<\/th><th>When the deletion runs<\/th><\/tr><\/thead><tbody><tr><td>destructiveChangesPre.xml<\/td><td>Before the rest of the package<\/td><\/tr><tr><td>destructiveChangesPost.xml<\/td><td>After the rest of the package<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Use the post version when a new field replaces an old one, so the new field exists before the old one goes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Limits and Things to Watch<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Deployments are asynchronous, so a pipeline must poll for the result<\/li>\n\n<li>There is a cap on components per deployment, so very large packages need splitting<\/li>\n\n<li>Profiles retrieve only the permissions related to the other components in the package<\/li>\n\n<li>Some settings are not covered, so a few steps stay manual at go live<\/li>\n\n<li>A failed test anywhere rolls back the whole deployment<\/li>\n\n<li>Field deletions destroy data, and a check only run does not warn you loudly enough<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The Salesforce Metadata API handles profiles in a way that catches almost everyone once. Retrieve a profile on its own and you get very little. Retrieve it alongside the objects and fields it governs and the file fills out. The post on <a href=\"https:\/\/swapnilzambare.com\/blog\/profiles-and-permission-sets-salesforce\/\">profiles and permission sets<\/a> explains what those permissions cover.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Common Mistakes with the Salesforce Metadata API<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Mistake<\/th><th>What you see<\/th><th>Fix<\/th><\/tr><\/thead><tbody><tr><td>Wildcards everywhere in the manifest<\/td><td>Very slow retrieves<\/td><td>Name the members you need<\/td><\/tr><tr><td>Retrieving a profile alone<\/td><td>An almost empty file<\/td><td>Retrieve it with the related components<\/td><\/tr><tr><td>No check only run before a release<\/td><td>Failures in the window<\/td><td>Validate first, deploy second<\/td><\/tr><tr><td>Deleting a field without a backup<\/td><td>Data gone with no recovery<\/td><td>Export the data before the destructive run<\/td><\/tr><tr><td>Treating deploy as synchronous<\/td><td>A pipeline that reports success too early<\/td><td>Poll the job id until it finishes<\/td><\/tr><tr><td>One giant package<\/td><td>Hitting the component cap<\/td><td>Split by feature or by object<\/td><\/tr><tr><td>Using it to read one class<\/td><td>Slow and awkward<\/td><td>Use the Tooling API instead<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Best Practices for the Salesforce Metadata API<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Keep the manifest in version control beside the source<\/li>\n\n<li>Name members explicitly rather than using wildcards in a release package<\/li>\n\n<li>Always run a check only deployment before a production release<\/li>\n\n<li>Export data before any destructive change to a field or object<\/li>\n\n<li>Set an explicit test level so you know what ran<\/li>\n\n<li>Split very large releases into packages that deploy in a known order<\/li>\n\n<li>Use the Tooling API for anything a developer tool needs to read quickly<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Most Asked Salesforce Metadata API Interview Questions<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q1: What does the Metadata API move?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Configuration rather than records. Objects, fields, classes, layouts, Flows and permissions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q2: What is package.xml?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The manifest that names which components a retrieve or deploy covers.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q3: What does an asterisk mean in a manifest member?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Every component of that type, which makes retrieves slow on a large org.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q4: Which two operations matter most?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Retrieve, which pulls configuration into files, and deploy, which pushes files into an org.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q5: Are deployments synchronous?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No. The call returns a job id and you poll it until the job finishes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q6: What is a check only deployment?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A validation run that executes tests and dependency checks without changing anything.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q7: Why is that useful before a release?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">It proves the package will deploy, hours before the release window opens.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q8: What happens if one test fails during a deployment?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The whole deployment rolls back, since it is a single transaction.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q9: How do you delete components?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With a destructive changes manifest alongside an empty package manifest.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q10: What is the difference between the pre and post destructive files?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pre runs before the rest of the package and post runs after it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q11: When would you use the post version?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When a new field replaces an old one and must exist before the old one is removed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q12: Why does retrieving a profile alone give you almost nothing?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Profile permissions are returned only for components also in the package.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q13: What is the Tooling API for?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Reading and editing single metadata items immediately, which suits editors and admin tools.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q14: How do you query with the Tooling API?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With a SOQL style query against a tooling endpoint over REST.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q15: Name three things the Tooling API exposes that the Salesforce Metadata API does not.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Code coverage results, trace flags and the symbol table for an Apex class.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q16: Which API does a code editor use to open a class?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Tooling API, because it answers immediately with the class body.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q17: Which API would a release pipeline use?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Metadata API, since it deploys whole packages as one transaction.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q18: Can the Tooling API deploy three hundred components?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No. That is squarely the job of the Metadata API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q19: What test levels can a deployment use?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Options such as no tests, specified tests, local tests and all tests in the org.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q20: Which test level suits a production release?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Local tests at a minimum, so your own tests all run.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q21: Scenario: a pipeline reports success but nothing changed. Why?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">It did not poll the job, so it read the queued response as a finished one.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q22: Scenario: a retrieve takes forty minutes. What is the usual cause?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Wildcards in the manifest pulling every component of several types.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q23: Scenario: a field was deleted and the data is gone. Was that avoidable?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Yes, with a data export before the destructive deployment.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q24: Does the Metadata API cover every setting in the org?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No. A short list of settings stays manual, so document those steps for go live.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q25: How does it relate to change sets?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Change sets are a user interface over the same idea, with no version control behind them.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q26: Can you use it from Apex?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There is limited Apex support for metadata operations, though release work normally runs outside the org.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q27: How do you split a very large release?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">By feature or object, deployed in a known order so dependencies land first.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q28: Why keep the manifest in Git?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">So the record of what shipped is a commit rather than a screenshot.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Q29: What is the habit that prevents most release pain?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Validate with a check only deployment every time, and never use wildcards in a release package.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Official Resources<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/developer.salesforce.com\/docs\/atlas.en-us.api_meta.meta\/api_meta\/\" target=\"_blank\" rel=\"noopener noreferrer\">Metadata API Developer Guide<\/a><\/li>\n\n<li><a href=\"https:\/\/developer.salesforce.com\/docs\/atlas.en-us.api_tooling.meta\/api_tooling\/\" target=\"_blank\" rel=\"noopener noreferrer\">Tooling API Developer Guide<\/a><\/li>\n\n<li><a href=\"https:\/\/developer.salesforce.com\/docs\/atlas.en-us.sfdx_dev.meta\/sfdx_dev\/\" target=\"_blank\" rel=\"noopener noreferrer\">Salesforce DX Developer Guide<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">What Is Next<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Next, read <a href=\"https:\/\/swapnilzambare.com\/blog\/salesforce-streaming-api-pushtopics\/\">Salesforce Streaming API and PushTopics Explained<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Salesforce Metadata API moves configuration rather than data. Objects, fields, page layouts, Apex classes, Flows, profiles and permission sets all travel through it.&hellip;<\/p>\n","protected":false},"author":1,"featured_media":2473,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_swapz_level":"","_swapz_series_part":0,"_swapz_hide_toc":false,"_swapz_hide_featured":false,"_swapz_description":"","footnotes":""},"categories":[246,8,96],"tags":[68,130,81],"swapz_series":[],"class_list":["post-2476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-integration-apis","category-salesforce","category-salesforce-developer","tag-advanced","tag-devops","tag-integration"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Salesforce Metadata API and Tooling API Guide<\/title>\n<meta name=\"description\" content=\"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Salesforce Metadata API and Tooling API Guide\" \/>\n<meta property=\"og:description\" content=\"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Swapnil Zambare - Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-30T03:30:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-15T16:30:03+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1260\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Swapnil Zambare\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Swapnil Zambare\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/\"},\"author\":{\"name\":\"Swapnil Zambare\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#\\\/schema\\\/person\\\/10b09224c8bcc562716e86789427592a\"},\"headline\":\"Salesforce Metadata API and Tooling API Explained\",\"datePublished\":\"2026-10-30T03:30:00+00:00\",\"dateModified\":\"2026-11-15T16:30:03+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/\"},\"wordCount\":1810,\"publisher\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/salesforce-metadata-tooling-api-featured.png\",\"keywords\":[\"Advanced\",\"DevOps\",\"Integration\"],\"articleSection\":[\"Integration and APIs\",\"Salesforce\",\"Salesforce Developer\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/\",\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/\",\"name\":\"Salesforce Metadata API and Tooling API Guide\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/salesforce-metadata-tooling-api-featured.png\",\"datePublished\":\"2026-10-30T03:30:00+00:00\",\"dateModified\":\"2026-11-15T16:30:03+00:00\",\"description\":\"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#primaryimage\",\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/salesforce-metadata-tooling-api-featured.png\",\"contentUrl\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/salesforce-metadata-tooling-api-featured.png\",\"width\":2400,\"height\":1260,\"caption\":\"Salesforce Metadata API featured image showing configuration moving between two orgs\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/salesforce-metadata-tooling-api\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Salesforce Metadata API and Tooling API Explained\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/\",\"name\":\"Swapnil Zambare - Blog\",\"description\":\"Salesforce &amp; Tech Guides\",\"publisher\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#organization\",\"name\":\"Swapnil Zambare - Blog\",\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/09\\\/site-icon-512.png\",\"contentUrl\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/09\\\/site-icon-512.png\",\"width\":512,\"height\":512,\"caption\":\"Swapnil Zambare - Blog\"},\"image\":{\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/in\\\/theSwapnilZambare\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/#\\\/schema\\\/person\\\/10b09224c8bcc562716e86789427592a\",\"name\":\"Swapnil Zambare\",\"sameAs\":[\"https:\\\/\\\/swapnilzambare.com\\\/blog\"],\"url\":\"https:\\\/\\\/swapnilzambare.com\\\/blog\\\/author\\\/swapnil-zambare\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Salesforce Metadata API and Tooling API Guide","description":"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/","og_locale":"en_US","og_type":"article","og_title":"Salesforce Metadata API and Tooling API Guide","og_description":"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.","og_url":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/","og_site_name":"Swapnil Zambare - Blog","article_published_time":"2026-10-30T03:30:00+00:00","article_modified_time":"2026-11-15T16:30:03+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png","type":"image\/png"}],"author":"Swapnil Zambare","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Swapnil Zambare","Est. reading time":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#article","isPartOf":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/"},"author":{"name":"Swapnil Zambare","@id":"https:\/\/swapnilzambare.com\/blog\/#\/schema\/person\/10b09224c8bcc562716e86789427592a"},"headline":"Salesforce Metadata API and Tooling API Explained","datePublished":"2026-10-30T03:30:00+00:00","dateModified":"2026-11-15T16:30:03+00:00","mainEntityOfPage":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/"},"wordCount":1810,"publisher":{"@id":"https:\/\/swapnilzambare.com\/blog\/#organization"},"image":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#primaryimage"},"thumbnailUrl":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png","keywords":["Advanced","DevOps","Integration"],"articleSection":["Integration and APIs","Salesforce","Salesforce Developer"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/","url":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/","name":"Salesforce Metadata API and Tooling API Guide","isPartOf":{"@id":"https:\/\/swapnilzambare.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#primaryimage"},"image":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#primaryimage"},"thumbnailUrl":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png","datePublished":"2026-10-30T03:30:00+00:00","dateModified":"2026-11-15T16:30:03+00:00","description":"The Salesforce Metadata API moves org configuration between orgs, while the Tooling API reads and edits single items fast. Learn when to use each one.","breadcrumb":{"@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#primaryimage","url":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png","contentUrl":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/11\/salesforce-metadata-tooling-api-featured.png","width":2400,"height":1260,"caption":"Salesforce Metadata API featured image showing configuration moving between two orgs"},{"@type":"BreadcrumbList","@id":"https:\/\/swapnilzambare.com\/blog\/salesforce-metadata-tooling-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/swapnilzambare.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Salesforce Metadata API and Tooling API Explained"}]},{"@type":"WebSite","@id":"https:\/\/swapnilzambare.com\/blog\/#website","url":"https:\/\/swapnilzambare.com\/blog\/","name":"Swapnil Zambare - Blog","description":"Salesforce &amp; Tech Guides","publisher":{"@id":"https:\/\/swapnilzambare.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/swapnilzambare.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/swapnilzambare.com\/blog\/#organization","name":"Swapnil Zambare - Blog","url":"https:\/\/swapnilzambare.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/swapnilzambare.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/09\/site-icon-512.png","contentUrl":"https:\/\/swapnilzambare.com\/blog\/wp-content\/uploads\/2026\/09\/site-icon-512.png","width":512,"height":512,"caption":"Swapnil Zambare - Blog"},"image":{"@id":"https:\/\/swapnilzambare.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/in\/theSwapnilZambare"]},{"@type":"Person","@id":"https:\/\/swapnilzambare.com\/blog\/#\/schema\/person\/10b09224c8bcc562716e86789427592a","name":"Swapnil Zambare","sameAs":["https:\/\/swapnilzambare.com\/blog"],"url":"https:\/\/swapnilzambare.com\/blog\/author\/swapnil-zambare\/"}]}},"_links":{"self":[{"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/posts\/2476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/comments?post=2476"}],"version-history":[{"count":2,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/posts\/2476\/revisions"}],"predecessor-version":[{"id":3396,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/posts\/2476\/revisions\/3396"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/media\/2473"}],"wp:attachment":[{"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/media?parent=2476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/categories?post=2476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/tags?post=2476"},{"taxonomy":"swapz_series","embeddable":true,"href":"https:\/\/swapnilzambare.com\/blog\/wp-json\/wp\/v2\/swapz_series?post=2476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}